IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

Articolo
05/23/2024

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

I driver client devono inviare questo IOCTL in 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

Input/Buffer di output

Sia i buffer di input che di output puntano a una struttura di USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION allocata dal chiamante. In 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 velocità superiore devono essere segnalate. Il driver hub restituisce informazioni sulla 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 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 dello 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.

Commenti

Ecco un esempio che illustra come recuperare le informazioni sulla velocità superiore 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);

Requisiti

Requisito	Valore
Intestazione	usbioctl.h

Condividi tramite