IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)

  • Articolo

La IOCTL_USB_GET_NODE_CONNECTION_NAME richiesta di controllo I/O viene usata con la struttura USB_NODE_CONNECTION_NAME per recuperare il nome simbolico del collegamento dell'hub collegato alla porta downstream.

IOCTL_USB_GET_NODE_CONNECTION_NAME è 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

Il membro AssociatedIrp.SystemBuffer punta a una struttura USB_NODE_CONNECTION_NAME . In input, il membro ConnectionIndex di questa struttura deve indicare il numero della porta da verificare per un hub collegato.

Lunghezza del buffer di input

Dimensione di una struttura USB_NODE_CONNECTION_NAME .

Buffer di output

AssociateIrp.SystemBuffer punta a una struttura USB_NODE_CONNECTION_NAME . In output, questa struttura contiene il nome simbolico dell'hub collegato nel membro HubName . Se non è collegato alcun hub, l'hub non ha un collegamento simbolico o il dispositivo collegato non è un hub, HubName[0] conterrà un valore di UNICODE_NULL.

Lunghezza del buffer di output

Il membro Parameters.DeviceIoControl.OutputBufferLength contiene le dimensioni, in byte, dell'intera struttura USB_NODE_CONNECTION_NAME .

Blocco dello stato

Lo stack USB imposta Irp-IoStatus.Status> su STATUS_SUCCESS se la richiesta ha esito positivo. La richiesta segnala l'esito positivo, anche se non è collegato alcun hub, l'hub collegato non ha alcun collegamento simbolico o il dispositivo collegato non è un hub.

In caso contrario, lo stack USB imposta Stato sulla condizione di errore appropriata, ad esempio STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.

Requisiti

Requisito Valore
Intestazione usbioctl.h (include Usbioctl.h)

Vedi anche

USB_NODE_CONNECTION_NAME