Skip to main content

XUserGetDefaultAudioEndpointUtf16

특정 사용자의 기본 오디오 엔드포인트를 가져옵니다.

구문

매개변수

user   
형식: XUserLocalId
기본 오디오 엔드포인트를 가져올 사용자의 로컬 ID입니다.
defaultAudioEndpointKind   
형식: XUserDefaultAudioEndpointKind
사용자의 기본 오디오 엔드포인트가 오디오를 렌더링하는지 캡처하는지 지정하는 열거형 값입니다.
endpointIdUtf16Count   
형식: size_t
endpointIdUtf16 매개변수가 가리키는 버퍼의 wchar_t 개수입니다. XUserAudioEndpointMaxUtf16Count를 전달합니다.
endpointIdUtf16   _Out_writes_to_(endpointIdUtf16Count,endpointIdUtf16Used)
형식: wchar_t

사용자의 기본 오디오 엔드포인트의 ID를 포함합니다.
endpointIdUtf16Used   _Out_opt_
형식: size_t*
endpointIdUtf16 매개변수가 반환하는 ID의 실제 wchar_t 개수를 포함합니다.

반환값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 Error Codes를 참조하십시오.

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하십시오.
XUserGetDefaultAudioEndpointUtf16 함수는 XUserDefaultAudioEndpointKind 열거형을 인수로 받습니다. XUserDefaultAudioEndpointUtf16ChangedCallback 콜백 함수는 특정 사용자의 기본 오디오 엔드포인트가 변경될 때 호출됩니다. 기본 오디오 엔드포인트가 변경될 때 콜백을 받도록 등록하려면 XUserRegisterForDefaultAudioEndpointUtf16Changed를 호출합니다. 기본 오디오 엔드포인트가 변경될 때 콜백 받기를 등록 해제하려면 XUserUnregisterForDefaultAudioEndpointUtf16Changed를 호출합니다. 다음 예제는 사용자의 기본 오디오 엔드포인트를 가져오는 방법을 보여줍니다.

요구 사항

헤더: XUser.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XUser XUserDefaultAudioEndpointUtf16ChangedCallback XUserRegisterForDefaultAudioEndpointUtf16Changed XUserUnregisterForDefaultAudioEndpointUtf16Changed
마지막 수정일 2026년 8월 24일