> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIXBeginRetailEvent

> PIXBeginRetailEvent

# PIXBeginRetailEvent

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

## 構文

```cpp theme={null}
void PIXBeginRetailEvent(  
         void* context,  
         UINT64 color,  
         PCWSTR formatString,
         ...  
)  
```

### パラメーター

*context*   \
Type: void\*

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

*color*   \
Type: UINT64

システム タイミング チャートで使用するイベントの色です。色を指定するには [PIX\_COLOR](/reference/tools/pix3/functions/pix_color)、色のインデックスを指定するには [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index) を使用します。または、フォーマットが ARGB で、alpha チャネルの値が 0xff でなければならないことに注意しつつ、生の DWORD を渡すこともできます。\
*formatString*   \_In\_\
Type: PCWSTR

イベントを説明するために使用する名前で、NULL 終端の Unicode 文字列へのポインターとして指定します。この文字列には、`sprintf` の書式指定に非常に近い形式で、任意の書式指定プレースホルダーを 0 個以上指定できます。

Type: ...

*formatString* にプレースホルダーが使用されている場合、対応する数のパラメーターを、プレースホルダーに応じた型で渡す必要があります。このメソッドは最大 16 個の書式パラメーターをサポートします。

### 戻り値

Type: void

## 解説

デバッグ デバイスまたは計測用デバイスでは、`PIXBeginRetailEvent` は [PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent) と同じ動作をします。リテール デバイスでは、これらのイベントは GPU ハング デバッグ用の HIX ファイルに含まれます。

`PIXBeginRetailEvent` と `PIXEndRetailEvent` のペアは、任意の深さでネストできます。

## 要件

**ヘッダー:** pix3.h

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

## 関連項目

[PIX (NDA トピック)](/tools/tools-console/pix/pix)\
[pix3](/reference/tools/pix3/pix3_members)\
[PIXEndRetailEvent](/reference/tools/pix3/functions/pixendretailevent)\
[PIXBeginRetailEvent(void\*, UINT64, PCSTR, ...)](/reference/tools/pix3/functions/pixbeginretailevent)


## Related topics

- [PIXBeginRetailEvent 関数](/ja-jp/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXEndRetailEvent](/ja-jp/reference/tools/pix3/functions/pixendretailevent.md)
- [PIXSetRetailMarker](/ja-jp/reference/tools/pix3/functions/pixsetretailmarker_2.md)
- [PIXBeginEvent 関数](/ja-jp/reference/tools/pix3/functions/pixbeginevent-overloads.md)
- [PIXSetRetailMarker function](/ja-jp/reference/tools/pix3/functions/pixsetretailmarker.md)