IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

Articolo
02/07/2025

La richiesta di IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION recupera le informazioni sulla corsia super velocità della porta USB.

I driver client devono inviare questo IOCTL a un IRQL di PASSIVE_LEVEL.

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION è una richiesta di controllo I/O in modalità utente. Questa richiesta è destinata al dispositivo hub USB (GUID_DEVINTERFACE_USB_HUB).

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input/output

Sia i buffer di input che di output puntano a una struttura di USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION allocata dal chiamante. All'input, il membro ConnectionIndex di questa struttura deve contenere un numero maggiore o uguale a 1 che indica il numero della porta le cui informazioni sulla corsia con velocità superiore devono essere segnalate. Il driver hub restituisce informazioni sulla corsia con velocità superiore nei membri rimanenti della struttura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION. L'IRP, il membro AssociatedIrp.SystemBuffer punta alla struttura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION.

In caso di output, la struttura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION riceve informazioni sulle corsie di super velocità indicate dal driver dell'hub USB.

Lunghezza del buffer di input/output

Dimensione di una struttura USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION.

Blocco di stato

Lo stack USB imposta Irp->IoStatus.Status su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, lo stack USB imposta Stato sulla condizione di errore appropriata, ad esempio STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.

Osservazioni

Ecco un esempio che mostra come recuperare le informazioni sulla corsia super velocità della porta 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);

Fabbisogno

Requisito	Valore
intestazione	usbioctl.h

Condividi tramite