PIXBeginRetailEvent
ユーザー定義のリテール イベントを開始します。構文
パラメーター
contextType: void* イベントのコンテキストです。
ID3D12GraphicsCommandList\*、ID3D12GraphicsCommandList\*、および ID3D12XboxDmaCommandList\* (XBOX のみ) を受け付けます。
color Type: UINT64 システム タイミング チャートで使用するイベントの色です。色を指定するには PIX_COLOR、色のインデックスを指定するには PIX_COLOR_INDEX を使用します。または、フォーマットが ARGB で、alpha チャネルの値が 0xff でなければならないことに注意しつつ、生の DWORD を渡すこともできます。
formatString _In_
Type: PCWSTR イベントを説明するために使用する名前で、NULL 終端の Unicode 文字列へのポインターとして指定します。この文字列には、
sprintf の書式指定に非常に近い形式で、任意の書式指定プレースホルダーを 0 個以上指定できます。
Type: …
formatString にプレースホルダーが使用されている場合、対応する数のパラメーターを、プレースホルダーに応じた型で渡す必要があります。このメソッドは最大 16 個の書式パラメーターをサポートします。
戻り値
Type: void解説
デバッグ デバイスまたは計測用デバイスでは、PIXBeginRetailEvent は PIXBeginEvent と同じ動作をします。リテール デバイスでは、これらのイベントは GPU ハング デバッグ用の HIX ファイルに含まれます。
PIXBeginRetailEvent と PIXEndRetailEvent のペアは、任意の深さでネストできます。
要件
ヘッダー: pix3.h ライブラリ: pixevt.lib サポートされているプラットフォーム: XBOX One ファミリ本体および XBOX Series 本体関連項目
PIX (NDA トピック)pix3
PIXEndRetailEvent
PIXBeginRetailEvent(void*, UINT64, PCSTR, …)