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

# GameInputRawDeviceReportItemInfo（已弃用）

> GameInputRawDeviceReportItemInfo

# GameInputRawDeviceReportItemInfo

> [!WARNING]
>
> **已弃用。** 此结构已在 GameInput v1 中移除，当前 API 中不再提供。当前的 [GameInputRawDeviceReportInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/structs/gameinputrawdevicereportinfo.md) 使用不同的项描述符。

描述原始 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](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputrawdevicephysicalunitkind.md)

此项的物理单位系统。

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

原始 HID 物理单位值。

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

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

**flags**\
类型：[GameInputRawDeviceReportItemFlags](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputrawdevicereportitemflags.md)

描述项属性的标志。

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

此项的 HID 用法数量。

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

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

**collection**\
类型：const [GameInputRawDeviceItemCollectionInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputrawdeviceitemcollectioninfo.md)\*

此项所属的集合。

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

项的可选标签。

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

父集合的可选标签。

## 版本历史

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

## 另请参阅

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


## Related topics

- [GameInputRawDeviceReportItemFlags（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputrawdevicereportitemflags.md)
- [GameInputRawDeviceItemCollectionInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputrawdeviceitemcollectioninfo.md)
- [GameInputRawDevicePhysicalUnitKind（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputrawdevicephysicalunitkind.md)
- [GameInputRawDeviceItemCollectionKind（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputrawdeviceitemcollectionkind.md)
- [IGameInputDevice::SetRawDeviceFeature（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_setrawdevicefeature.md)