次の方法で共有

PIXBeginRetailEvent

  • [アーティクル]

ユーザー定義のリテール イベントを開始します。

構文

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

パラメーター

context   
型: void*

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

color   
型: UINT64

システム タイミング チャートで使用するイベントの色。 PIX_COLOR を使用して色を指定するか、PIX_COLOR_INDEX を使用してカラー インデックスを指定するか、または形式が ARGB でアルファ チャンネルは 0xff であることを示す生の DWORD を渡します。
formatString _In_
型: PCWSTR

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

型: ...

formatString でプレースホルダーを使用する場合は、対応する数のパラメーターが存在します。パラメーターの型はプレースホルダーによって決まります。 このメソッドは、最大 16 の書式パラメーターをサポートします。

戻り値

型: void

解説

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

PIXBeginRetailEvent と PIXEndRetailEvent のペアは任意の深さまで入れ子にできます。

要件

ヘッダー: pix3.h

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

関連項目

PIX (NDA トピック)
pix3
PIXEndRetailEvent
PIXBeginRetailEvent(void*, UINT64, PCSTR, ...)