注册应用程序广播状态更改事件处理程序。
语法
HRESULT XAppBroadcastRegisterIsAppBroadcastingChanged(
XTaskQueueHandle queue,
void* context,
XAppBroadcastMonitorCallback* appBroadcastMonitorCallback,
XTaskQueueRegistrationToken* token
)
参数
queue _In_opt_
类型:XTaskQueueHandle
可选的 XTaskQueueHandle,用户可以在其中创建要从此队列执行的自己的回调。
context _In_opt_
类型:void*
要传递到回调函数的可选信息。
appBroadcastMonitorCallback _In_
类型:XAppBroadcastMonitorCallback*
针对是否可以广播或未更改的状态的回调。 游戏可以使用它来了解允许显示广播 UI 是否安全。
token _Out_
类型:XTaskQueueRegistrationToken*
广播令牌。
返回值
类型:HRESULT
函数结果。
备注
注意
在时间敏感线程上调用此函数是不安全的。 有关详细信息,请参阅时间敏感线程。
当不再需要事件处理程序时,每次调用 AppBroadcastRegisterIsAppBroadcastingChanged 后应接着调用 XAppBroadcastUnregisterIsAppBroadcastingChanged。 未能调用取消注册函数将导致发生内存泄漏。 此函数将注册第二个函数 XAppBroadcastMonitorCallback(当应用广播状态更改时将调用它)。
要求
头文件:XAppCapture.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机
另请参阅
GameDVR 概述
XAppCapture 成员
XAppBroadcastUnregisterIsAppBroadcastingChanged
XAppBroadcastMonitorCallback