PIXSetMarker 関数
特定のユーザー定義イベントが発生したときに、PIX の System Timing Capture ウィンドウの CPU タイムラインにマーカーを挿入します。構文
パラメーター
colorType: UINT64 PIX ウィンドウでこのイベントが発生したときに、タイミング チャートで使用される色です。 色を指定するには PIX_COLOR、色インデックスを指定するには PIX_COLOR_INDEX を使用します。または、フォーマットが ARGB で、alpha チャネルの値が 0xff でなければならないことに注意しつつ、生の DWORD を渡すこともできます。 formatString _In_
Type: PCSTR イベントを説明するために使用する名前です。この文字列には、
sprintf の書式指定に非常に近い形式で、任意の書式指定プレースホルダーを 0 個以上指定できます。
Type: …
formatString にプレースホルダーが使用されている場合、プレースホルダーに一致する型のパラメーターを対応する数 (最大 16 個まで) 指定する必要があります。
戻り値
Type: void解説
PIXSetMarker 関数は、実行時に文字列を書式設定するのではなく、書式文字列と書式パラメーターを保存します。書式設定は、PIX でキャプチャ ファイルを読み込むときに行われます。最良のパフォーマンスを得るには、PIXSetMarker で 16 バイト境界に配置された文字列 (推奨)、または 8 バイト境界に配置された文字列を使用してください。%p 書式指定子を使って char* または wchar_t* をポインターとして表示するには、PIXSetMarker に渡す際にそのポインターを void*、または整数型あるいは浮動小数点型へのポインターにキャストします。PIXSetMarker の呼び出しには、記録データを保存するために少なくとも 512 バイトの領域が保証されます。
このイベントは長さのない状態で表示され、PIX System Timing Capture ウィンドウでは 1 本の縦線 (単一の垂直バー) として表現されます。
この関数は CPU タイムラインでイベントをマークするために使用します。GPU タイムラインでイベントをマークするには、PIXSetMarker 関数の 3 番目のオーバーロード、または PIXSetMarker 関数の 4 番目のオーバーロード を呼び出します。
PIXSetMarker の呼び出しはどこでも行うことができ、PIXBeginEvent の呼び出しに続く必要はありません。
要件
ヘッダー: pix3.h ライブラリ: pixevt.lib サポートされているプラットフォーム: XBOX One ファミリ本体および XBOX Series 本体関連項目
PIXSetMarker_2PIXSetMarker_3
PIXSetMarker_4
PIX3
PIX (NDA トピック)