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

# PIXSetMarker 関数

> PIXSetMarker 関数

# PIXSetMarker 関数

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

## 構文

```cpp theme={null}
void PIXSetMarker(  
         UINT64 color,  
         PCSTR formatString,  
         ...  
)  
```

### パラメーター

*color*   \
Type: UINT64

PIX ウィンドウでこのイベントが発生したときに、タイミング チャートで使用される色です。

色を指定するには [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: 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 番目のオーバーロード](/reference/tools/pix3/functions/pixsetmarker_3)、または [PIXSetMarker 関数の 4 番目のオーバーロード](/reference/tools/pix3/functions/pixsetmarker_4) を呼び出します。

`PIXSetMarker` の呼び出しはどこでも行うことができ、[PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent) の呼び出しに続く必要はありません。

## 要件

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

**ライブラリ:** pixevt.lib

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

## 関連項目

[PIXSetMarker\_2](/reference/tools/pix3/functions/pixsetmarker_2)\
[PIXSetMarker\_3](/reference/tools/pix3/functions/pixsetmarker_3)\
[PIXSetMarker\_4](/reference/tools/pix3/functions/pixsetmarker_4)\
[PIX3](/reference/tools/pix3/pix3_members)\
[PIX (NDA トピック)](/tools/tools-console/pix/pix)


## Related topics

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