次の方法で共有

PIXSetRetailMarker

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

構文

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

パラメーター

context   
型: void*

イベントのコンテキスト。ID3D12GraphicsCommandList\*、ID3D12CommandQueue*、および ID3D12XboxDmaCommandList* (Xbox のみ) を受け付けます。

color   
型: UINT64

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

formatString _In_
型: PCWSTR

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

型: ...

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

戻り値

型: void

解説

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

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

要件

ヘッダー: pix3.h

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

関連項目

PIX の概要 (NDA トピック)
pix3
PIXSetRetailMarker(void*, UINT64, PCSTR, ...)
PIXBeginRetailEvent

  • Last updated on