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