IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)

  • Articolo

La richiesta di IOCTL_USB_GET_NODE_CONNECTION_INFORMATION recupera informazioni sulla porta USB indicata e sul dispositivo collegato alla porta, se presente.

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

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION è una richiesta di controllo di 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_INFORMATION allocata dall'utente che descrive la connessione. In input, il membro ConnectionIndex di questa struttura contiene il numero di porta.

Lunghezza del buffer di input

Dimensione di una struttura USB_NODE_CONNECTION_INFORMATION .

Buffer di output

Nell'output il membro Parameters.DeviceIoControl.OutputBufferLength contiene le dimensioni dei dati di output. Questa dimensione è variabile, perché dipende dal numero di pipe associate alla porta.

AssociatedIrp.SystemBuffer punta a una struttura USB_NODE_CONNECTION_INFORMATION allocata dall'utente che contiene i dati di output.

Lunghezza del buffer di output

Dimensione di una struttura USB_NODE_CONNECTION_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 status sulla condizione di errore appropriata, ad esempio STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.

Commenti

La richiesta di IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX è una versione estesa di IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. Le due richieste sono identiche, ad eccezione del fatto che la versione estesa della richiesta può segnalare connessioni basse, complete e ad alta velocità e le richieste di IOCTL_USB_GET_NODE_CONNECTION_INFORMATION precedenti segnalano solo connessioni a bassa e massima velocità. Per altre informazioni sulla differenza tra queste due richieste, vedere USB_NODE_CONNECTION_INFORMATION e USB_NODE_CONNECTION_INFORMATION_EX.

Requisiti

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

Vedi anche

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX