> ## 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.

# PIXSetRetailMarker

> PIXSetRetailMarker

# PIXSetRetailMarker

特定のユーザー定義イベントが発生したときに、リテール マーカーを挿入します。

## Syntax

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

### Parameters

*context*   \
型: void\*

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

*color*   \
型: UINT64

このイベントが PIX ウィンドウで発生したときにタイミング チャートで使用される色。\
色を指定するには [PIX\_COLOR](/reference/tools/pix3/functions/pix_color) を使用し、カラー インデックスを指定するには [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index) を使用します。また、生の DWORD を渡すこともできますが、この形式は ARGB であり、アルファ チャネルの値は 0xff である必要があります。

*formatString*   \_In\_\
型: PCWSTR

イベントを説明するために使用する名前。null 終端の Unicode 文字列へのポインターとして指定します。この文字列は、**sprintf** の書式指定に似た省略可能な文字列書式プレースホルダーを 0 個以上指定できます。

型: ...

**formatString** にプレースホルダーが使用されている場合、それに対応する個数 (最大 16 個) のパラメーターを、プレースホルダーと一致する型で指定する必要があります。

### Return value

型: void

## Remarks

デバッグ デバイスまたは計測対応デバイスでは、`PIXSetRetailMarker` は [PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker) と同じように動作します。リテール デバイスでは、マーカーは GPU ハング デバッグのために HIX ファイルに含められます。

`PIXSetRetailMarker` の呼び出しはどこにでも配置でき、[PIXBeginRetailEvent](/reference/tools/pix3/functions/pixbeginretailevent) の呼び出しに続いて行う必要はありません。

## Requirements

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

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

## See also

[PIX overview (NDA topic)](/tools/tools-console/pix/pix)\
[pix3](/reference/tools/pix3/pix3_members)\
[PIXSetRetailMarker(void\*, UINT64, PCSTR, ...)](/reference/tools/pix3/functions/pixsetretailmarker)\
[PIXBeginRetailEvent](/reference/tools/pix3/functions/pixbeginretailevent)


## Related topics

- [PIXSetRetailMarker function](/ja-jp/reference/tools/pix3/functions/pixsetretailmarker.md)
- [PIXSetMarker](/ja-jp/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [PIXSetMarker reference](/ja-jp/reference/tools/pix3/functions/pixsetmarker_2.md)
- [PIXSetMarker overview](/ja-jp/reference/tools/pix3/functions/pixsetmarker_4.md)
- [PIXSetMarker 関数](/ja-jp/reference/tools/pix3/functions/pixsetmarker.md)