IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)
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
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) |