Skip to main content

​
XUserRegisterForDefaultAudioEndpointUtf16Changed

기본 오디오 엔드포인트가 변경될 때 애플리케이션이 정의하고 호출하는 콜백을 등록합니다.

​
구문

​
매개변수

queue   _In_opt_
형식: XTaskQueueHandle 변경 콜백을 배치할 비동기 큐에 대한 핸들입니다. context   _In_opt_
형식: void* 애플리케이션이 정의하고 콜백에 전달하는 컨텍스트입니다. callback   _In_
형식: XUserDefaultAudioEndpointUtf16ChangedCallback* 애플리케이션이 정의하고 오디오 엔드포인트 변경 이벤트에 대해 등록하는 콜백입니다. token   _Out_
형식: XTaskQueueRegistrationToken* 성공 시 콜백을 식별하는 토큰을 받습니다. 콜백을 등록 취소하려면 이 토큰을 XUserUnregisterForDefaultAudioEndpointUtf16Changed 함수에 전달합니다.

​
반환값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.
오류 코드 목록은 Error Codes를 참조하십시오.

​
설명

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 Time-sensitive threads를 참조하십시오.
이전에 등록된 기본 오디오 엔드포인트 변경 콜백을 등록 취소하려면 XUserUnregisterForDefaultAudioEndpointUtf16Changed를 호출합니다. 사용자 디바이스 연결 콜백을 등록하려면 XUserRegisterForDeviceAssociationChanged를 호출합니다. 이전에 등록된 사용자 디바이스 연결 변경 콜백을 등록 취소하려면 XUserUnregisterForDeviceAssociationChanged를 호출합니다.

​
요구 사항

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

​
개념 문서

​
함께 보기

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

관련 항목

XUserDefaultAudioEndpointUtf16ChangedCallbackXUserUnregisterForDefaultAudioEndpointUtf16ChangedXUserGetDefaultAudioEndpointUtf16XUserRegisterForDeviceAssociationChangedXUserUnregisterForDeviceAssociationChanged