IOCTL_USB_GET_ROOT_HUB_NAME I/O 控件要求會與 USB_ROOT_HUB_NAME 結構搭配使用,以擷取根中樞的符號連結名稱。
IOCTL_USB_GET_ROOT_HUB_NAME 是使用者模式 I/O 控制要求。 此要求的目標是USB主機控制器(GUID_DEVINTERFACE_USB_HOST_CONTROLLER)。
主要程序代碼
輸入緩衝區
沒有。
輸入緩衝區長度
沒有。
輸出緩衝區
在輸出中,AssociatedIrp.SystemBuffer 成員指向包含根中樞符號連結名稱的 USB_ROOT_HUB_NAME 結構。 擷取的字串中不包含前置 “\xxx\” 文字。
輸出緩衝區長度
USB_ROOT_HUB_NAME 結構的大小。
狀態區塊
如果要求成功,USB 堆疊會將 Irp->IoStatus.Status Irp- STATUS_SUCCESS。 否則,USB 堆疊會將狀態 設定為適當的錯誤狀況,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。
如果移除或停止根中樞,要求會傳回STATUS_SUCCESS但字串為 NULL。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | usbioctl.h (包括 Usbioctl.h) |