次の方法で共有

PIXSetRetailMarker 関数

特定のユーザー定義のイベントが発生したときに、小売マーカーを挿入します。

構文

void PIXSetRetailMarker(  
         void* context,  
         UINT64 color,  
         PCSTR formatString,  
         ...  
)

パラメーター

context   
型: void*

イベントのコンテキストは、1ID3D12GraphicsCommandList*,ID3D12CommandQueue*andID3D12XboxDmaCommandList*' を受け入れます (Xbox のみ)。

color   
型: UINT64

PIX ウィンドウのタイミング チャートでこのイベントの発生時点に使用される色。
PIX_COLOR を使用して色を指定するか、PIX_COLOR_INDEX を使用してカラー インデックスを指定するか、または形式が ARGB でアルファ チャンネルは 0xff であることを示す生の DWORD を渡します。

formatString _In_
型: PCSTR

イベントを記述するために使用する名前。 この文字列では、sprintf 形式と同様に、任意の数の省略可能な文字列による書式設定のプレースホルダーを指定することもできます。

型: ...

formatString でプレースホルダーを使用する場合は、対応する数のパラメーター (最大 16) が存在します。パラメーターの型はプレースホルダーに一致します。

戻り値

型: void

解説

デバッグまたはインストルメント化されたデバイスでは、PIXSetRetailMarker は PIXSetMarker と同じ動作をします。 製品デバイスでは、マーカーは、GPU ハングのデバッグ用に HIX ファイルに含まれます。

PIXSetRetailMarker はいつでも呼び出すことができ、先に PIXBeginRetailEvent を呼び出す必要はありません。

要件

ヘッダー: pix3.h

ライブラリ: pixevt.lib サポートされているプラットフォーム: Xbox One ファミリ本体と Xbox Series 本体

関連項目

PIXSetRetailMarker(void*, UINT64, PCWSTR, ...)
pix3
PIX (NDA トピック)

  • Last updated on