共用方式為

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

  • 發行項

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION要求會擷取 USB 埠超速通道資訊。

用戶端驅動程序必須在PASSIVE_LEVEL IRQL 傳送此 IOCTL。

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

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入/輸出緩衝區

輸入和輸出緩衝區都會指向呼叫端配置的 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 結構。 在輸入時，這個 結構的 ConnectionIndex 成員必須包含大於或等於 1 的數位，指出要報告其超速通道資訊之埠的數目。 中樞驅動程式會在 USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 結構的其餘成員中傳回超速度通道資訊。 IRP，AssociatedIrp.SystemBuffer 成員會指向USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION結構。

在輸出時， USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 結構會從USB中樞驅動程式接收所指出超速度通道的相關信息。

輸入/輸出緩衝區長度

USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 結構的大小。

狀態區塊

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

備註

以下是示範如何擷取 USB 埠超速通道資訊的範例。

success = DeviceIoControl(hHubDevice,
                          IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION,
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          &nBytes,
                          NULL);

規格需求

需求 值
標頭 usbioctl.h

另請參閱