跳转到主要内容
检索设备上通用控制器按钮的标签。

语法

参数

labelArrayCount   _In_
类型:uint32_t
labelArray 中的元素数量。若要检索所有控制器按钮标签,请传递 GetControllerButtonCount 返回的值。 labelArray   _Out_writes_to_opt_(labelArrayCount, return)
类型:GameInputLabel*
指向数组的指针,该数组为每个控制器按钮接收一个标签。可以为 nullptr,在这种情况下不会写入任何内容,并且方法返回 0。

返回值

类型:uint32_t 写入 labelArray 的元素数量。该值为 labelArrayCount 与设备上控制器按钮标签数量中的较小者;如果 labelArray 为 nullptr 或设备没有控制器按钮标签,则为 0。

备注

每个元素都是一个 GameInputLabel 值,用于标识印在相应按钮上的标记(如果设备报告了该标记)。 调用 GetControllerButtonCount 获取控制器按钮标签的数量,分配该大小的数组,然后调用 GetControllerButtonLabels 填充该数组。如果 labelArrayCount 小于控制器按钮标签的数量,则只写入前 labelArrayCount 个元素。在设备保持连接期间,设备的控制器按钮标签不会更改,因此你可以只查询一次并缓存结果。 标签数组的元素 i 描述的是,对于来自此设备的读数,IGameInputReading::GetControllerButtonState 返回的数组中索引 i 处的按钮。 以下示例演示如何检索设备的控制器按钮标签。
在 GameInput v3 及更早版本中,此信息可从 GameInputControllerInfo 结构的 controllerButtonLabels 成员中获取,该结构由 IGameInputDevice::GetDeviceInfo 返回的 GameInputDeviceInfo 结构的 controllerInfo 成员引用。

要求

头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

GameInput 概述
GetControllerButtonCount
GameInputLabel
IGameInputReading::GetControllerButtonState
IGameInputDevice

版本历史

最后修改于 2026年11月6日