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

# PIXGetCaptureState

> PIXGetCaptureState

# PIXGetCaptureState

以一組旗標的形式，擷取正在進行中的擷取類型。

## 語法

```cpp theme={null}
DWORD PIXGetCaptureState(  
)  
```

### 參數

### 傳回值

類型：DWORD

擷取狀態旗標。如果未設定任何擷取狀態旗標，則會傳回零，表示 PIX 沒有進行中的擷取。

#### 旗標

| 旗標 | 值 | 描述 |
| - | - | - |
| PIX\_CAPTURE\_TIMING | (1 \<\< 0) | 系統計時。 |
| PIX\_CAPTURE\_GPU | (1 \<\< 1) | 擷取傳送至 GPU 的所有命令及其輸入，以便進行重播和分析。 |
| PIX\_CAPTURE\_FUNCTION\_SUMMARY | (1 \<\< 2) | 已從 **\[首頁]** 索引標籤起始函式摘要擷取。 |
| PIX\_CAPTURE\_FUNCTION\_DETAILS | (1 \<\< 3) | 已從函式摘要或呼叫圖擷取中，使用 **\[擷取其他呼叫]** 按鈕起始其他函式詳細資料的要求。 |
| 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 Streaming Performance Monitor (SPM) 計數器和 Shader Queue Thread Tracing (SQTT) 資料。 |
| PIX\_CAPTURE\_RESERVED | (1 \<\< 15) | PIX 在內部用於未來或特殊擷取案例的預留位置旗標。 |

## 備註

從 `PIXCaptureState` 擷取的旗標會用作 [PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture) 函式的參數。
在 [PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture) 的情況下，旗標會決定要起始哪種類型的 PIX 擷取。
您可以呼叫此函式來檢查目前正在執行的擷取類型，以確認擷取已正確開始。

## 需求

**標頭：** pix3.h

**程式庫：** pixevt.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture)\
[PIX3](/zh-TW/reference/tools/pix3/pix3_members)\
[PIX (NDA 主題)](/zh-TW/tools/tools-console/pix/pix)


## Related topics

- [PIXGetCaptureState](/reference/tools/pix3/functions/pixgetcapturestate.md)
- [PIX3](/reference/tools/pix3/pix3_members.md)
- [PIXCaptureParameters](/reference/tools/pix3/structs/pixcaptureparameters.md)