IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)
IOCTL_HID_GET_COLLECTION_INFORMATION要求會取得最上層集合 HID_COLLECTION_INFORMATION 結構。 此資訊包含集合 預先剖析資料的大小,以位元組為單位,。
如需 HIDClass 裝置的一般資訊,請參閱 HID 集合。
主要程序代碼
輸入緩衝區
參數.DeviceIoControl.OutputBufferLength 在 IRP 的 I/O 堆棧位置,表示輸出緩衝區的大小,以位元組為單位,輸出緩衝區的大小必須 >= 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 (include Hidclass.h) |