IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)

  • 發行項

IOCTL_HID_GET_COLLECTION_INFORMATION要求會取得 最上層集合的HID_COLLECTION_INFORMATION 結構。 這項資訊包含集合 預先剖析數據的大小，以位元組為單位。

如需 HIDClass 裝置的一般資訊，請參閱 HID 集合。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

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)

另請參閱

HID_COLLECTION_INFORMATION