共用方式為


IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)

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) 為目標。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

無。

輸入緩衝區長度

無。

輸出緩衝區

在輸出時, AssociatedIrp.SystemBuffer 成員會指向包含根中樞符號連結名稱 的USB_ROOT_HUB_NAME 結構。 擷取的字串中不包含前置 “\xxx\ ” 文字。

輸出緩衝區長度

USB_ROOT_HUB_NAME 結構的大小。

狀態區塊

如果要求成功,USB 堆疊會將 Irp-IoStatus.Status> 設定為STATUS_SUCCESS。 否則,USB 堆疊會將 [狀態 ] 設定為適當的錯誤狀況,例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。

如果移除或停止根中樞,要求會傳回STATUS_SUCCESS,但字串為 NULL。

規格需求

需求
標頭 usbioctl.h (包含 Usbioctl.h)

另請參閱

USB_ROOT_HUB_NAME