次の方法で共有

PIXSetMarker 関数

  • [アーティクル]

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

構文

void PIXSetMarker(  
         UINT64 color,  
         PCSTR formatString,  
         ...  
)

パラメーター

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 タイムラインでイベントをマークするために使用されます。 GPU タイムラインでイベントをマークするには、PIXSetMarker 関数の 3 番目のオーバーロードまたは PIXSetMarker 関数の 4 番目のオーバーロードを呼び出します。

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

要件

ヘッダー: pix3.h

ライブラリ: pixevt.lib

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

関連項目

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