進行中のキャプチャの種類をフラグのセットとして取得します。
構文
DWORD PIXGetCaptureState(
)
パラメーター
戻り値
型: DWORD
キャプチャ状態フラグ。 キャプチャ状態フラグが設定されていない場合は、0 が返されます。これは、PIX ではキャプチャが進行していないことを示します。
フラグ
| フラグ | 値 | 説明 |
|---|---|---|
| PIX_CAPTURE_TIMING | (1 << 0) | システム タイミング。 |
| PIX_CAPTURE_GPU | (1 << 1) | GPU に送信されたすべてのコマンドとその入力をキャプチャして、再生および分析できるようにします。 |
| PIX_CAPTURE_FUNCTION_SUMMARY | (1 << 2) | 関数の要約キャプチャーが [Home] タブから開始されました。 |
| PIX_CAPTURE_FUNCTION_DETAILS | (1 << 3) | 追加の関数詳細の要求が、関数の要約キャプチャーまたは呼び出し関係図キャプチャーから [Capture Additional Calls] ボタンを使用して開始されました。 |
| PIX_CAPTURE_CALLGRAPH | (1 << 4) | 呼び出し関係図キャプチャーが、PIX から、または PIXBeginCapture を呼び出すことでプログラムによって開始されました。 |
| PIX_CAPTURE_INSTRUCTION_TRACE | (1 << 5) | CPU 命令トレース キャプチャが進行中です。 |
| PIX_CAPTURE_SYSTEM_MONITOR_COUNTERS | (1 << 6) | システム モニター カウンター。 |
| PIX_CAPTURE_VIDEO | (1 << 7) | ビデオ再生。 |
| PIX_CAPTURE_AUDIO | (1 << 8) | オーディオ再生。 |
| PIX_CAPTURE_GPU_TRACE | (1 << 9) | ほぼすべての GPU ブロックから GPU ストリーミング パフォーマンス モニター (SPM) カウンターとシェーダー キュー スレッド トレーシング (SQTT) データをキャプチャします。 |
| PIX_CAPTURE_RESERVED | (1 << 15) | 将来または特殊なキャプチャ シナリオで PIX によって内部的に使用されるプレースホルダー フラグ。 |
解説
PIXCaptureState から取得したフラグは、PIXBeginCapture 関数のパラメーターとして使用されます。
PIXBeginCapture の場合、開始される Pix キャプチャの種類がこのフラグで決まります。
この関数を呼び出し、現在実行中のキャプチャの種類を確認することによって、キャプチャが正常に開始されたことを確認できます。
要件
ヘッダー: pix3.h
ライブラリ: pixevt.lib
サポートされているプラットフォーム: Xbox One ファミリ本体と Xbox Series 本体