IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME I/O 控制件要求會擷取與連線至指定埠之裝置相關聯的驅動程式登錄機碼名稱。
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME 是使用者模式 I/O 控制要求。 此要求會以 USB 中樞裝置 (GUID_DEVINTERFACE_USB_HUB) 為目標。
主要程序代碼
輸入緩衝區
AssociatedIrp.SystemBuffer 成員指向使用者配置的USB_NODE_CONNECTION_DRIVERKEY_NAME結構。 在此結構的 Input 上, 此結構的 ConnectionIndex 成員包含裝置所連接的埠數目。
輸入緩衝區長度
USB_NODE_CONNECTION_DRIVERKEY_NAME 結構的大小。
輸出緩衝區
輸出時,AssociatedIrp.SystemBuffer上USB_NODE_CONNECTION_DRIVERKEY_NAME結構的 DriverKeyName 成員包含與連線至 ConnectionIndex 所指示之埠之裝置相關聯的驅動程式密鑰名稱。
ActualLength 成員會指出驅動程式密鑰名稱的長度,以位元組為單位。 Parameters.DeviceIoControl.OutputBufferLength 成員會指出整個USB_NODE_CONNECTION_DRIVERKEY_NAME結構的大小,以位元組為單位。
輸出緩衝區長度
USB_NODE_CONNECTION_DRIVERKEY_NAME 結構的大小。
狀態區塊
如果要求成功,USB 堆疊會將 Irp-IoStatus.Status> 設定為STATUS_SUCCESS。 否則,USB 堆疊會將 [狀態 ] 設定為適當的錯誤狀況,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。
如果呼叫端配置足以保存所有輸出數據的輸出緩衝區, IoStatus.Information 會等於 ActualLength 的值。 如果輸出緩衝區夠大,足以儲存所有輸出資料, IoStatus.Information 就會等於 sizeof(USB_NODE_CONNECTION_DRIVERKEY_NAME)
。
規格需求
需求 | 值 |
---|---|
標頭 | usbioctl.h (包含 Usbioctl.h) |