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

# PIXEndCapture

> PIXEndCapture

# PIXEndCapture

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

## 構文

```cpp theme={null}
HRESULT PIXEndCapture(  
         BOOL discard  
)  
```

### パラメーター

*discard*   \
Type: BOOL

キャプチャを破棄するかどうかを示します。

* *discard* が TRUE の場合、キャプチャされたデータは破棄され、キャプチャは PIX で表示されません。
* *discard* が FALSE の場合、キャプチャされたデータは保存され、PIX に結果のキャプチャが表示されます。

*discard* パラメーターは、探していた条件に合致しなかったキャプチャを破棄するのに便利です。たとえば、`PIXBeginCapture` と `PIXEndCapture` を使って、事前定義された時間範囲内に収まる関数の呼び出しをキャプチャしようとすることができます。その範囲内に収まる関数呼び出しのキャプチャのみを表示したい場合に有用です。

### 戻り値

Type: HRESULT

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

## 解説

PIX キャプチャを開始するには、[PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture) を使用します。\
PIX キャプチャを開始するための要件について詳しくは、[PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture) の解説セクションをご覧ください。

以下の C++ サンプルは、PIX キャプチャの開始と終了の方法を示しています。

```cpp theme={null}
//
//  timing capture
//
PIXCaptureParameters captureParams = {};

captureParams.TimingCaptureParameters.CaptureGpuTiming = TRUE;
captureParams.TimingCaptureParameters.CaptureCallstacks = TRUE;
captureParams.TimingCaptureParameters.CaptureCpuSamples = TRUE;
captureParams.TimingCaptureParameters.CpuSamplesPerSecond = 4000;

captureParams.TimingCaptureParameters.CaptureStorage = PIXCaptureParameters::Memory;
captureParams.TimingCaptureParameters.FileName = wstrFilename;
captureParams.TimingCaptureParameters.MaximumToolingMemorySizeMb = 4096;

XSF_ERROR_IF_FAILED(PIXBeginCapture(PIX_CAPTURE_TIMING, &captureParams));

while (PIXEndCapture(FALSE) == E_PENDING)
{
    // Keep running
}

```

## 要件

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

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

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

## 関連項目

[PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)\
[PIX3](/reference/tools/pix3/pix3_members)\
[PIX (NDA トピック)](/tools/tools-console/pix/pix)


## Related topics

- [PIX3](/ja-jp/reference/tools/pix3/pix3_members.md)
- [XtfCaptureOutputEnd](/ja-jp/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputBegin](/ja-jp/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [XUserDefaultAudioEndpointKind](/ja-jp/reference/system/xuser/enums/xuserdefaultaudioendpointkind.md)
- [XAppCaptureVideoCaptureSettings](/ja-jp/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)