> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XApuGetResultCount

> XApuGetResultCount

# XApuGetResultCount

傳回結果佇列中 [XApuResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuresult.md) 的數目。

## 語法

```cpp theme={null}
uint32_t XApuGetResultCount(  
         XApuHandle handle,  
         uint32_t* totalResultCount  
)  
```

### 參數

*handle*   \_In\_\
類型: XApuHandle

呼叫 [XApuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md) 所傳回的控制代碼。

*totalResultCount*   \_Out\_opt\_\
類型: uint32\_t\*

XAPU 輸出/結果佇列中 [XApuResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuresult.md) 結構的數目。

### 傳回值

類型: uint32\_t

如果沒有提交任何命令，或沒有任何 [XApuResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuresult.md) 就緒，輸出會是零；否則傳回值會大於零。如果傳回值大於零，呼叫端必須針對結果佇列中包含的每個 [XApuResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuresult.md) 呼叫 [XApuDequeueResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapudequeueresult.md)。

## 備註

此方法會接受 uint32\_t 的指標，以傳回目前工作階段的 *totalResultCount*。

此數字代表自工作階段開始並呼叫 [XApuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md) 之後，已處理的結果總數。

第一次 [XApuDequeueResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapudequeueresult.md) 時此數字會是一，並隨著更多命令獲得處理且結果可供取用而持續增加。此數字不會歸零。

## 需求

**標頭:** xapu.h

**程式庫:** xapu.lib

**支援的平台:** XBOX Series X|S

## 另請參閱

[XAPU](https://docs.xbox.com/zh-TW/reference/audio/xapu/xapu_members.md)


## Related topics

- [XApuDequeueResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapudequeueresult.md)
- [XApuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md)
- [XAPU](https://docs.xbox.com/zh-TW/reference/audio/xapu/xapu_members.md)
- [XApuConnectOutputParameters](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [XblPrivacyGetAvoidListResultCount](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/privacy_c/functions/xblprivacygetavoidlistresultcount.md)