为用户设备关联更改事件注册回调。
语法
HRESULT XUserRegisterForDeviceAssociationChanged(
XTaskQueueHandle queue,
void* context,
XUserDeviceAssociationChangedCallback* callback,
XTaskQueueRegistrationToken* token
)
参数
queue _In_opt_
类型:XTaskQueueHandle
要将更改回调置于其上的异步队列句柄。
context _In_opt_
类型:void*
应用程序定义并传回到回调的回调。
callback _In_
类型:XUserDeviceAssociationChangedCallback*
应用程序定义和注册的回调。
token _Out_
类型:XTaskQueueRegistrationToken*
成功时包含一个标识回调的令牌,您可以使用该令牌取消注册回调。
返回值
类型:HRESULT
HRESULT 成功或错误代码。
有关错误代码的列表,请参阅错误代码。
备注
注意
在时间敏感线程上调用此函数是不安全的。 有关详细信息,请参阅时间敏感线程。
调用 XUserDeviceAssociationRegisterForChangeEvent 不会使以前注册的回调无效。
要取消注册用户设备关联更改回调,请调用 XUserUnregisterForDeviceAssociationChanged。
要注册默认终结点更改时应用程序定义和调用的回调,请调用 XUserRegisterForDefaultAudioEndpointUtf16Changed。
要取消注册默认音频终结点更改回调,请调用 XUserUnregisterForDefaultAudioEndpointUtf16Changed。
要求
头文件:XUser.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机
另请参阅
XUserUnregisterForDeviceAssociationChanged