XUserRegisterForDefaultAudioEndpointUtf16Changed

기본 오디오 끝점이 변경될 때 애플리케이션이 정의하고 호출하는 콜백을 등록합니다.

구문

HRESULT XUserRegisterForDefaultAudioEndpointUtf16Changed(  
         XTaskQueueHandle queue,  
         void* context,  
         XUserDefaultAudioEndpointUtf16ChangedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  

매개 변수

queue _In_opt_
형식: XTaskQueueHandle

변경 콜백을 배치할 비동기 큐에 대한 핸들입니다.

context _In_opt_
형식: void*

애플리케이션이 정의해 콜백에 전달하는 컨텍스트입니다.

callback _In_
형식: XUserDefaultAudioEndpointUtf16ChangedCallback*

애플리케이션 오디오 끝점 변경 이벤트에 대해 정의하고 등록하는 콜백입니다.

token _Out_
형식: XTaskQueueRegistrationToken*

성공 시, 콜백을 식별하는 토큰을 수신합니다. 콜백을 등록 해제하려면 이 토큰을 XUserUnregisterForDefaultAudioEndpointUtf16Changed 함수로 전달합니다.

반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.
오류 코드 목록은 오류 코드를 참조하세요.

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

이전에 등록한 기본 오디오 끝점 변경 콜백을 등록 해제하려면, XUserUnregisterForDefaultAudioEndpointUtf16Changed를 호출합니다.

사용자 장치 연결 콜백을 등록하려면 XUserRegisterForDeviceAssociationChanged를 호출합니다.

이전에 등록한 사용자 장치 연결 변경 콜백을 등록 해제하려면 XUserUnregisterForDeviceAssociationChanged를 호출합니다.

요건

헤더: XUser.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XUser
XUserDefaultAudioEndpointUtf16ChangedCallback
XUserUnregisterForDefaultAudioEndpointUtf16Changed