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

# XInputGetAudioDeviceIds

> XInputGetAudioDeviceIds

# XInputGetAudioDeviceIds

<Note>이 함수는 아직 구현되지 않았습니다.</Note>

지정된 컨트롤러에 연결된 헤드셋의 오디오 렌더링 및 캡처 장치의 ID를 검색합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
DWORD XInputGetAudioDeviceIds( 
         DWORD dwUserIndex,​
         LPWSTR pRenderDeviceId,​
         UINT * pRenderCount,​
         LPWSTR pCaptureDeviceId,​
         UINT * pCaptureCount
)​ 
```

<a id="parametersSection" />

### 매개변수

*dwUserIndex*   \_In\_\
형식: DWORD

헤드셋과 연결된 게이머의 인덱스입니다. 값은 0에서 `XUSER_MAX_COUNT - 1` 범위입니다.

*pRenderDeviceId*    \_Out\_writes\_opt\_z\_(\*pRenderCount)\
형식: LPWSTR

오디오 렌더링 장치의 ID입니다. 즉, 헤드폰과 같이 오디오 출력을 재생하는 장치입니다.

*pRenderCount*     \_Inout\_opt\_\
형식: UINT\*

렌더링 장치 ID를 위한 문자열 버퍼의 크기(와이드 문자 단위)입니다.

*pCaptureDeviceId*    \_Out\_writes\_opt\_z\_(\*pCaptureCount)\
형식: LPWSTR

오디오 캡처 장치의 ID입니다. 즉, 마이크와 같이 오디오 입력을 캡처하는 장치입니다.

*pCaptureCount*    \_Inout\_opt\_\
형식: UINT\*

캡처 장치 ID를 위한 문자열 버퍼의 크기(와이드 문자 단위)입니다.

<a id="retvalSection" />

### 반환값

형식: DWORD

함수가 렌더링 및 캡처의 장치 ID를 성공적으로 검색하면 반환 코드는 `ERROR_SUCCESS`입니다.

컨트롤러에 헤드셋이 연결되어 있지 않은 경우에도 함수는 `ERROR_SUCCESS`를 반환하며, *pRenderDeviceId* 및 *pCaptureDeviceId*의 값은 `NULL`입니다.

컨트롤러 포트 장치가 물리적으로 연결되어 있지 않으면 함수는 `ERROR_DEVICE_NOT_CONNECTED`를 반환합니다.

함수가 실패하면 Win32 오류 코드를 반환합니다.

<a id="remarksSection" />

## 설명

호출자는 이 함수에 전달되는 버퍼에 대한 메모리를 할당해야 합니다. 결과 문자열은 임의의 길이일 수 있습니다.

자세한 내용은 [XInputOnGameInput 래퍼](/build/core-features/common/input/porting/input-porting-xinput#xinputWrapperSection)를 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** XInputOnGameInput.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

<a id="seealsoSection" />

## 참고 항목

[XInput에서 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XInputOnGameInput](/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [PartyLocalChatControl::GetAudioInput](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput.md)
- [GameInputDeviceStatus](/ko/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [XInputGetDeviceId](/ko/reference/input/xinputongameinput/functions/xinputgetdeviceid.md)
- [GameInput의 햅틱](/ko/build/core-features/common/input/hardware/input-hardware-haptics.md)