IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)

IOCTL_USB_GET_NODE_CONNECTION_NAME I/O 控件要求會與USB_NODE_CONNECTION_NAME結構搭配使用，以擷取附加至下游埠之中樞的符號連結名稱。

IOCTL_USB_GET_NODE_CONNECTION_NAME 是使用者模式 I/O 控制要求。 此要求是以 USB 中樞裝置 (GUID_DEVINTERFACE_USB_HUB) 為目標。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

AssociatedIrp.SystemBuffer 成員指向USB_NODE_CONNECTION_NAME結構。 在輸入時，此結構的 ConnectionIndex 成員必須指出要檢查鏈接中樞的埠數目。

輸入緩衝區長度

USB_NODE_CONNECTION_NAME 結構的大小。

輸出緩衝區

AssociatedIrp.SystemBuffer 指向 USB_NODE_CONNECTION_NAME 結構。 輸出時，這個結構包含 HubName 成員中附加中樞的符號名稱。 如果沒有鏈接中樞，中樞沒有符號連結，或鏈接的裝置不是中樞， HubName[0] 將會包含UNICODE_NULL的值。

輸出緩衝區長度

Parameters.DeviceIoControl.OutputBufferLength 成員包含整個USB_NODE_CONNECTION_NAME結構的大小，以位元組為單位。

狀態區塊

如果要求成功，USB 堆疊會將 Irp-IoStatus.Status> 設定為STATUS_SUCCESS。 要求會報告成功，即使沒有鏈接中樞，附加中樞沒有符號連結，或鏈接的裝置不是中樞。

否則，USB 堆疊會將 [狀態 ] 設定為適當的錯誤狀況，例如STATUS_INVALID_PARAMETER或STATUS_INSUFFICIENT_RESOURCES。

規格需求

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

另請參閱

USB_NODE_CONNECTION_NAME