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

# XApuGetUtilization

> XApuGetUtilization

# XApuGetUtilization

取得指定處理類型與通道數目之硬體伺服器的目前使用率值。

## 語法

```cpp theme={null}
HRESULT XApuGetUtilization(  
         XApuProcessType processType,  
         uint32_t channelCount,  
         XApuUtilization* utilization  
)  
```

### 參數

*processType*   \_In\_\
類型：[XApuProcessType](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapuprocesstype.md)

XAPU 執行的單一處理程序或處理程序鏈結。

*channelCount*   \_In\_\
類型：uint32\_t

通道數目。

*utilization*   \_Outptr\_\
類型：[XApuUtilization\*](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuutilization.md)

傳回的使用率參數。

### 傳回值

類型：HRESULT

如果成功，會傳回 `S_OK`；否則會傳回錯誤碼。

## 備註

此函式使用 `processType` 參數傳遞給 `XApuProcessType` 列舉。它使用 `channelCount` 參數指定處理類型與通道數目。它使用 `XApuUtilization` 列舉來定義傳回的使用率參數。如需詳細資訊，請參閱 [XApuUtilization](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuutilization.md)。

## 需求

**標頭：** xapu.h

**程式庫：** xapu.lib

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

## 另請參閱

[XApuProcessType](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapuprocesstype.md)\
[XApuUtilization](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuutilization.md)\
[XAPU](https://docs.xbox.com/zh-TW/reference/audio/xapu/xapu_members.md)


## Related topics

- [XApuUtilization](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuutilization.md)
- [XApuProcessType](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapuprocesstype.md)
- [XAPU](https://docs.xbox.com/zh-TW/reference/audio/xapu/xapu_members.md)
- [build_region_utilization](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/MultiplayerServers/build-region-utilization.md)
- [BuildRegionUtilizationEventPayload](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/data-types/buildregionutilizationeventpayload.md)