IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)
驅動程式會使用 IOCTL_INTERNAL_USB_GET_HUB_NAME I/O 要求,以在 PDO 用於中樞時擷取目標 PDO 的 UNICODE 符號名稱。 否則會傳回 NULL 字串。
驅動程式可以使用符號名稱,透過使用者模式 I/O 控件要求和 WMI 呼叫擷取中樞的其他資訊。
IOCTL_INTERNAL_USB_GET_HUB_NAME 是內核模式 I/O 控制要求。 此要求是以USB中樞 PDO 為目標。 此要求必須在PASSIVE_LEVEL的 IRQL 傳送。
主要程序代碼
IRP_MJ_INTERNAL_DEVICE_CONTROL
輸入緩衝區
Irp->AssociatedIrp.SystemBuffer 指向 USB_HUB_NAME 結構。
輸入緩衝區長度
Parameters.DeviceIoControl.OutputBufferLength 是在 Irp->AssociatedIrp.SystemBuffer 字段中傳遞的緩衝區長度。
輸出緩衝區
Irp->AssociatedIrp.SystemBuffer 會填入根中樞的符號名稱。
輸出緩衝區長度
根中樞符號名稱的長度。
狀態區塊
較低層級的驅動程式會將 Irp->IoStatus.Status 設定為STATUS_SUCCESS或適當的錯誤狀態。 它將 Irp->IoStatus.Information 設定為保留USB_ROOT_HUB_NAME結構所需的位元元組數目。 如果要求失敗,驅動程式可以使用這項資訊,以足夠大的緩衝區重新提交要求。
要求
要求 | 價值 |
---|---|
標頭 | usbioctl.h (包括 Usbioctl.h) |