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

# XApuGetUtilization

> XApuGetUtilization

# XApuGetUtilization

지정된 프로세스 유형 및 채널 수에 대해 하드웨어 서버의 현재 사용률 값을 가져옵니다.

## Syntax

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

### Parameters

*processType*   \_In\_\
Type: [XApuProcessType](/reference/audio/xapu/enums/xapuprocesstype)

XAPU가 수행하는 단일 프로세스 또는 프로세스 체인입니다.

*channelCount*   \_In\_\
Type: uint32\_t

채널 수입니다.

*utilization*   \_Outptr\_\
Type: [XApuUtilization\*](/reference/audio/xapu/structs/xapuutilization)

반환되는 사용률 매개 변수입니다.

### Return value

Type: HRESULT

성공 시 `S_OK`를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

## Remarks

이 함수는 `XApuProcessType` 열거형에 전달할 `processType` 매개 변수를 사용합니다. 지정된 프로세스 유형 및 채널 수에 대해 `channelCount` 매개 변수를 사용합니다. 반환되는 사용률 매개 변수를 정의하기 위해 `XApuUtilization` 열거형을 사용합니다. 자세한 내용은 [XApuUtilization](/reference/audio/xapu/structs/xapuutilization)을 참조하세요.

## Requirements

**Header:** xapu.h

**Library:** xapu.lib

**Supported platforms:** XBOX Series X|S

## See also

[XApuProcessType](/reference/audio/xapu/enums/xapuprocesstype)\
[XApuUtilization](/reference/audio/xapu/structs/xapuutilization)\
[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

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