Skip to main content

​
XUserRegisterForDefaultAudioEndpointUtf16Changed

註冊由應用程式定義，並在預設音訊端點變更時叫用的回呼。

​
語法

​
參數

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
Last modified on October 6, 2026