次の方法で共有

PIXSetMarker 関数参照

特定のユーザー定義イベントが発生したときに、PIX の [System Timing Capture] ウィンドウの GPU タイムラインにマーカーを挿入します。

構文

void PIXSetMarker(  
         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

解説

PIXSetMarker 関数は、実行時に文字列を書式設定するのではなく、書式文字列と書式パラメーターを保存します。 その後、PIX でキャプチャ ファイルを読み取るときに書式設定が行われます。 パフォーマンスを最適化するには、PIXSetMarker で 16 バイトにアライメントされた文字列 (推奨) または 8 バイトにアライメントされた文字列を使用します。 %p 書式指定子を使用して char* または wchar_t* をポインターとして出力するには、PIXSetMarker に渡すときに、ポインターを void* に、またはポインターを整数型または浮動小数点数型にキャストします。 PIXSetMarker の呼び出しでは、レコード データを保存するために 512 バイト以上の領域が保証されます。

このイベントは継続しないものとして表示され、PIX の [System Timing Capture] ウィンドウでは 1 つの線 (1 つの縦線) で表されます。

この関数は、CPU タイムラインでイベントをマークするために使用されます。 CPU タイムラインでイベントをマークするには、PIXSetMarker 関数の 1 番目のオーバーロードまたは PIXSetMarker 関数の 2 番目のオーバーロードを呼び出します。

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

要件

ヘッダー: pix3.h

ライブラリ: pixevt.lib

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

関連項目

PIXSetMarker
PIXSetMarker_2
PIXSetMarker_4
PIX3
PIX (NDA トピック)

  • Last updated on