IOCTL_GET_PHYSICAL_DESCRIPTOR IOCTL (hidclass.h)

IOCTL_GET_PHYSICAL_DESCRIPTOR要求會取得 最上層集合的實體描述項。 對於迷你驅動程式，此描述項是 HIDClass 裝置的描述項。

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

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

IRP I/O 堆疊位置中的 Parameters.DeviceIoControl.OutputBufferLength 表示輸出緩衝區的大小，以位元組為單位。

輸出緩衝區

Irp->MdlAddress 必須指向將接收實體描述元的緩衝區。

HID 迷你驅動程式會將實體描述項複製到 Irp-UserBuffer> 的用戶緩衝區。

狀態區塊

HID 類別驅動程式會將 Irp-IoStatus> 的 Status 成員設定為STATUS_SUCCESS如果傳輸完成而沒有錯誤。 否則，它會設定為適當的NTSTATUS錯誤碼。

對裝置執行 I/O 的 HID 迷你驅動程式會設定下列 Irp-IoStatus> 字段：

• 信息 會設定為從裝置傳輸的位元元組數目。
• 如果 傳輸完成且沒有錯誤，狀態會設定為STATUS_SUCCESS。 否則，它會設定為適當的NTSTATUS錯誤碼。

使用此 IRP 呼叫其他驅動程式的 HID 迷你驅動程式，以執行其裝置的 I/O，應確保狀態區塊 的資訊欄位正確 無誤，且不會變更 [狀態 ] 欄位的內容。

規格需求

需求	值
標頭	hidclass.h (包含 Hidclass.h)

另請參閱

HidD_GetPhysicalDescriptor