注册在默认音频终结点更改时应用程序定义和调用的回调。
语法
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