Condividi tramite


IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)

La richiesta di controllo I/O IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME recupera il nome della chiave del Registro di sistema del driver associato al dispositivo connesso alla porta indicata.

IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_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_DRIVERKEY_NAME allocata dall'utente. All'input, il ConnectionIndex membro di questa struttura contiene il numero della porta a cui è connesso il dispositivo.

Lunghezza del buffer di input

Dimensione di una struttura USB_NODE_CONNECTION_DRIVERKEY_NAME.

Buffer di output

In output, il DriverKeyName membro della struttura USB_NODE_CONNECTION_DRIVERKEY_NAME in AssociatedIrp.SystemBuffer contiene il nome della chiave del driver associato al dispositivo connesso alla porta indicata da ConnectionIndex.

Il membro ActualLength indica la lunghezza, espressa in byte, del nome della chiave del driver. Il membro Parameters.DeviceIoControl.OutputBufferLength indica le dimensioni, in byte, dell'intera struttura USB_NODE_CONNECTION_DRIVERKEY_NAME.

Lunghezza del buffer di output

Dimensione di una struttura USB_NODE_CONNECTION_DRIVERKEY_NAME.

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.

Se il chiamante alloca un buffer di output sufficientemente grande da contenere tutti i dati di output, IoStatus.Information sarà uguale al valore di ActualLength. Se il buffer di output è sufficientemente grande da contenere tutti i dati di output, IoStatus.Information sarà uguale a sizeof(USB_NODE_CONNECTION_DRIVERKEY_NAME).

Fabbisogno

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

Vedere anche

USB_NODE_CONNECTION_DRIVERKEY_NAME