다음을 통해 공유


XInputGetAudioDeviceIds 함수(xinput.h)

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

구문

DWORD XInputGetAudioDeviceIds(
  [in]                DWORD  dwUserIndex,
  [out, optional]     LPWSTR pRenderDeviceId,
  [in, out, optional] UINT   *pRenderCount,
  [out, optional]     LPWSTR pCaptureDeviceId,
  [in, out, optional] UINT   *pCaptureCount
);

매개 변수

[in] dwUserIndex

디바이스와 연결된 게이머의 인덱스입니다.

[out, optional] pRenderDeviceId

렌더링(스피커)에 대한 Windows Core 오디오 디바이스 ID 문자열입니다.

[in, out, optional] pRenderCount

렌더링 디바이스 ID 문자열 버퍼의 크기(와이드 문자)입니다.

[out, optional] pCaptureDeviceId

캡처용 Windows Core 오디오 디바이스 ID 문자열(마이크).

[in, out, optional] pCaptureCount

캡처 디바이스 ID 문자열 버퍼의 크기(와이드 문자)입니다.

반환 값

함수가 렌더링 및 캡처를 위해 디바이스 ID를 성공적으로 검색하면 반환 코드가 ERROR_SUCCESS.

컨트롤러에 연결된 헤드셋이 없는 경우 함수는 pRenderDeviceIdpCaptureDeviceId에 대한 값으로 NULL이 있는 ERROR_SUCCESS 검색합니다.

컨트롤러 포트 디바이스가 물리적으로 연결되지 않은 경우 함수는 ERROR_DEVICE_NOT_CONNECTED 반환합니다.

함수가 실패하면 유효한 Win32 오류 코드가 반환됩니다.

설명

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

플랫폼 요구 사항

Windows 8(XInput 1.4)

요구 사항

   
대상 플랫폼 Windows
헤더 xinput.h
라이브러리 Xinput.lib
DLL Xinput1_4.dll

참고 항목

핵심 오디오 API

XInput 함수

XInputGetDSoundAudioDeviceGuids