Skip to main content

XGameStreamingRegisterClientPropertiesChanged

注册一个回调,当任何流式处理客户端设备的属性发生更改时调用该回调。
注册后,将使用客户端设备当前的客户端属性调用回调。

语法

参数

client   _In_
类型:XGameStreamingClientId
你正在为其注册以获取回调的游戏流式处理客户端的 ID。 queue   _In_opt_
类型:XTaskQueueHandle
用于放置更改回调的异步队列的句柄。 context   _In_opt_
类型:void*
指向将传递给回调函数的上下文的可选指针。 callback   _In_
类型:XGameStreamingClientPropertiesChangedCallback*
当客户端属性发生更改时将调用的回调函数。 token   _Out_
类型:XTaskQueueRegistrationToken*
指向可用于从事件中取消注册的注册令牌的指针。

返回值

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

潜在错误

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

备注

在时间敏感线程上调用此函数并不安全。有关详细信息,请参阅时间敏感线程
此 API 允许游戏在 XGameStreamingClientProperty(如流物理尺寸)发生更改时接收 XGameStreamingClientPropertiesChangedCallback 注册导致回调被所有适用的 XGameStreamingClientProperty 调用,以便可以查询当前属性详细信息。 当流式处理客户端设备断开连接时,请使用 XGameStreamingUnregisterClientPropertiesChanged 注销回调。

示例

要求

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

概念性文档

另请参阅

XGameStreamingClientProperty
XGameStreamingClientPropertiesChangedCallback
XGameStreamingUnregisterClientPropertiesChanged
XGameStreaming
最后修改于 2026年8月24日