IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)
IOCTL_HID_GET_COLLECTION_INFORMATION要求會取得 最上層集合的HID_COLLECTION_INFORMATION 結構。 這項資訊包含集合 預先剖析數據的大小,以位元組為單位。
如需 HIDClass 裝置的一般資訊,請參閱 HID 集合。
主要程序代碼
輸入緩衝區
IRP I/O 堆棧位置中的 Parameters.DeviceIoControl.OutputBufferLength 表示輸出緩衝區的大小,以位元組為單位,這必須是 >= sizeof (HID_COLLECTION_INFORMATION) 。
輸入緩衝區長度
大於或等於 sizeof (HID_COLLECTION_INFORMATION) 。
輸出緩衝區
Irp->AssociatedIrp.SystemBuffer 指向將接收集合信息的緩衝區。 此數據會在要求者提供的緩衝區中格式化為HID_COLLECTION_INFORMATION結構。
輸出緩衝區長度
HID_COLLECTION_INFORMATION 結構的大小。
狀態區塊
HID 類別驅動程式會設定下列 Irp-IoStatus> 字段:
- 如果成功擷取數據,則資訊會設定為sizeof (HID_COLLECTION_INFORMATION) 。
- 如果 傳輸完成且沒有錯誤,狀態會設定為STATUS_SUCCESS。 否則,它會設定為適當的NTSTATUS錯誤碼。
規格需求
需求 | 值 |
---|---|
標頭 | hidclass.h (包含 Hidclass.h) |