Skip to main content

XGameStreamingRegisterConnectionStateChanged

注册一个回调,当流式处理客户端设备的连接状态发生更改时调用该回调。注册后,将为所有已连接的流式处理客户端设备调用回调。

语法

参数

queue   _In_opt_
类型:XTaskQueueHandle
用于放置更改回调的异步队列的句柄。 context   _In_opt_
类型:void*
指向传递给回调函数的上下文的可选指针。 callback   _In_
类型:XGameStreamingConnectionStateChangedCallback*
当任何流式处理客户端设备的连接状态发生更改时将调用的回调函数。 token   _Out_
类型:XTaskQueueRegistrationToken*
指向可用于从事件中取消注册的注册令牌的指针。

返回值

类型:HRESULT 如果成功,则返回 S_OK;否则返回错误代码。

潜在错误

有关错误代码列表,请参阅错误代码

备注

在时间敏感线程上调用此函数并不安全。有关详细信息,请参阅时间敏感线程
此 API 是建议的方式,可让游戏针对每个流式处理客户端设备进行自定义并维护状态,从而允许游戏根据是否有任何设备连接来优化体验。
注册后,将为所有当前已连接的流式处理客户端设备调用回调。

示例

要求

标头: xgamestreaming.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念性文档

另请参阅

XGameStreamingConnectionState
XGameStreamingConnectionStateChangedCallback
XGameStreamingUnregisterConnectionStateChanged
XGameStreaming
最后修改于 2026年8月24日