PIXSetRetailMarker
特定のユーザー定義イベントが発生したときに、リテール マーカーを挿入します。Syntax
Parameters
context型: void* イベントのコンテキスト。ID3D12GraphicsCommandList* 、ID3D12CommandQueue* 、および ID3D12XboxDmaCommandList* (XBOX のみ) を受け付けます。 color
型: UINT64 このイベントが PIX ウィンドウで発生したときにタイミング チャートで使用される色。
色を指定するには PIX_COLOR を使用し、カラー インデックスを指定するには PIX_COLOR_INDEX を使用します。また、生の DWORD を渡すこともできますが、この形式は ARGB であり、アルファ チャネルの値は 0xff である必要があります。 formatString _In_
型: PCWSTR イベントを説明するために使用する名前。null 終端の Unicode 文字列へのポインターとして指定します。この文字列は、sprintf の書式指定に似た省略可能な文字列書式プレースホルダーを 0 個以上指定できます。 型: … formatString にプレースホルダーが使用されている場合、それに対応する個数 (最大 16 個) のパラメーターを、プレースホルダーと一致する型で指定する必要があります。
Return value
型: voidRemarks
デバッグ デバイスまたは計測対応デバイスでは、PIXSetRetailMarker は PIXSetMarker と同じように動作します。リテール デバイスでは、マーカーは GPU ハング デバッグのために HIX ファイルに含められます。
PIXSetRetailMarker の呼び出しはどこにでも配置でき、PIXBeginRetailEvent の呼び出しに続いて行う必要はありません。
Requirements
ヘッダー: pix3.h ライブラリ: pixevt.lib サポートされているプラットフォーム: XBOX One ファミリー本体および XBOX Series 本体See also
PIX overview (NDA topic)pix3
PIXSetRetailMarker(void*, UINT64, PCSTR, …)
PIXBeginRetailEvent