IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)

  • Articolo

La IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME richiesta di controllo I/O 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. In input, il membro ConnectionIndex di questa struttura contiene il numero della porta a cui è connesso il dispositivo.

Lunghezza del buffer di input

Dimensioni di una struttura USB_NODE_CONNECTION_DRIVERKEY_NAME .

Buffer di output

In output, il membro DriverKeyName 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, 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

Dimensioni di una struttura USB_NODE_CONNECTION_DRIVERKEY_NAME .

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.

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

Requisiti

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

Vedi anche

USB_NODE_CONNECTION_DRIVERKEY_NAME