Skip to main content

XGameStreamingGetTouchBundleVersion

获取指定设备上当前正在使用的触摸适配包的版本。

语法

参数

client   _In_
类型:XGameStreamingClientId
正在查询的流式处理客户端。 version   _Out_opt_
类型:XVersion*
指定客户端上当前正在使用的包的版本号。如果包中未指定版本号,则将返回 0.0.0.0。 versionNameSize   _In_
类型:size_t
要返回的 versionName 的最大大小(以字节为单位)。可通过调用 XGameStreamingGetTouchBundleVersionNameSize 找到指定的大小。 versionName   _Out_writes_opt_z_
类型:char*
指定客户端上当前正在使用的包的版本名称。如果包中未指定版本名称,则将返回 null

返回值

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

潜在错误

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

备注

在游戏流式处理期间向玩家呈现的触摸布局使用作为触摸适配包的一部分上传到 Microsoft 的预定义布局。XGameStreamingGetTouchBundleVersion 使游戏能够根据特定客户端上使用的一组触摸控件做出运行时决策。可能使用此功能的一些示例:
  • 如果玩家正在使用触摸且元素可通过触摸叠加控件使用,则从 HUD 中删除该元素。
  • 根据将要显示的触摸布局决定在游戏中显示哪些图形提示。
version 对上传到服务的每个版本都是唯一的。每次更新都需要一个新的版本号。 versionName 可用于提供语义版本(例如,这是一组支持 DLC2 的布局),而不是锁定到特定的版本号。例如,如果版本号由你的构建系统自动分配,则游戏代码可能难以知道运行时将出现的触摸适配包的确切版本号。为了让代码能够检测包的存在而无需知道其确切版本,它可以选择使用版本名称而不是基于版本号进行比较。

示例

要求

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

另请参阅

XGameStreaming
XGameStreamingGetTouchBundleVersionNameSize
最后修改于 2026年8月24日