> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputRawDeviceReportItemInfo

> GameInputRawDeviceReportItemInfo

# GameInputRawDeviceReportItemInfo

<Warning>**已弃用。** 此结构已在 GameInput v1 中移除，当前 API 中不再提供。当前的 [GameInputRawDeviceReportInfo](/reference/input/gameinput/structs/gameinputrawdevicereportinfo) 使用不同的项描述符。</Warning>

描述原始 HID 设备报告中的单个数据项。

## 语法

```cpp theme={null}
typedef struct GameInputRawDeviceReportItemInfo {
    uint32_t bitOffset;
    uint32_t bitSize;
    int64_t logicalMin;
    int64_t logicalMax;
    int64_t physicalMin;
    int64_t physicalMax;
    GameInputRawDevicePhysicalUnitKind physicalUnits;
    uint32_t rawPhysicalUnits;
    int32_t rawPhysicalUnitsExponent;
    GameInputRawDeviceReportItemFlags flags;
    uint32_t usageCount;
    const GameInputUsage* usages;
    const GameInputRawDeviceItemCollectionInfo* collection;
    const GameInputLabel* itemLabel;
    const GameInputLabel* collectionLabel;
} GameInputRawDeviceReportItemInfo;
```

## 成员

**bitOffset**\
类型：uint32\_t

此项在报告中的位偏移量。

**bitSize**\
类型：uint32\_t

此项的大小（以位为单位）。

**logicalMin, logicalMax**\
类型：int64\_t

此项的逻辑（原始）值范围。

**physicalMin, physicalMax**\
类型：int64\_t

此项的物理值范围（应用单位指数后）。

**physicalUnits**\
类型：[GameInputRawDevicePhysicalUnitKind](/reference/input/gameinput/deprecated/enums/gameinputrawdevicephysicalunitkind)

此项的物理单位系统。

**rawPhysicalUnits**\
类型：uint32\_t

原始 HID 物理单位值。

**rawPhysicalUnitsExponent**\
类型：int32\_t

应用于原始物理值的十进制指数。

**flags**\
类型：[GameInputRawDeviceReportItemFlags](/reference/input/gameinput/deprecated/enums/gameinputrawdevicereportitemflags)

描述项属性的标志。

**usageCount**\
类型：uint32\_t

此项的 HID 用法数量。

**usages**\
类型：const GameInputUsage\*

指向 `usageCount` 个用法数组的指针。

**collection**\
类型：const [GameInputRawDeviceItemCollectionInfo](/reference/input/gameinput/deprecated/structs/gameinputrawdeviceitemcollectioninfo)\*

此项所属的集合。

**itemLabel**\
类型：const GameInputLabel\*

项的可选标签。

**collectionLabel**\
类型：const GameInputLabel\*

父集合的可选标签。

## 版本历史

| 版本     | 变更   |
| ------ | ---- |
| **v1** | 已移除。 |
| **v0** | 已引入。 |

## 另请参阅

[已弃用的 GameInput API 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[GameInputRawDeviceItemCollectionInfo](/reference/input/gameinput/deprecated/structs/gameinputrawdeviceitemcollectioninfo)
[GameInputRawDevicePhysicalUnitKind](/reference/input/gameinput/deprecated/enums/gameinputrawdevicephysicalunitkind)
[GameInputRawDeviceReportItemFlags](/reference/input/gameinput/deprecated/enums/gameinputrawdevicereportitemflags)


## Related topics

- [GameInputRawDeviceReportItemFlags](/zh-CN/reference/input/gameinput/deprecated/enums/gameinputrawdevicereportitemflags.md)
- [GameInputRawDeviceItemCollectionInfo](/zh-CN/reference/input/gameinput/deprecated/structs/gameinputrawdeviceitemcollectioninfo.md)
- [GameInputRawDevicePhysicalUnitKind](/zh-CN/reference/input/gameinput/deprecated/enums/gameinputrawdevicephysicalunitkind.md)
- [GameInput](/zh-CN/reference/input/gameinput/gameinput_members.md)
- [已弃用的 GameInput API 成员](/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)