Skip to main content

PIXEndCapture

PIXBeginCapture で開始された、プログラム制御のキャプチャを停止します。

構文

パラメーター

discard   
Type: BOOL
キャプチャを破棄するかどうかを示します。
  • discard が TRUE の場合、キャプチャされたデータは破棄され、キャプチャは PIX で表示されません。
  • discard が FALSE の場合、キャプチャされたデータは保存され、PIX に結果のキャプチャが表示されます。
discard パラメーターは、探していた条件に合致しなかったキャプチャを破棄するのに便利です。たとえば、PIXBeginCapturePIXEndCapture を使って、事前定義された時間範囲内に収まる関数の呼び出しをキャプチャしようとすることができます。その範囲内に収まる関数呼び出しのキャプチャのみを表示したい場合に有用です。

戻り値

Type: HRESULT キャプチャが正常に完了したかどうかを示します。成功時には S_OK が返されます。この操作は非同期であり、キャプチャが完全に停止するまで E_PENDING を返します。結果が E_PENDING の間、タイトルは終了したり新しいキャプチャを開始したりしてはいけません。

解説

PIX キャプチャを開始するには、PIXBeginCapture を使用します。
PIX キャプチャを開始するための要件について詳しくは、PIXBeginCapture の解説セクションをご覧ください。
以下の C++ サンプルは、PIX キャプチャの開始と終了の方法を示しています。

要件

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

関連項目

PIXBeginCapture
PIX3
PIX (NDA トピック)
最終更新日 2026年8月24日