IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)
La solicitud de control de E/S de IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME recupera el nombre de clave del Registro del controlador asociado al dispositivo que está conectado al puerto indicado.
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME es una solicitud de control de E/S en modo de usuario. Esta solicitud tiene como destino el dispositivo concentrador USB (GUID_DEVINTERFACE_USB_HUB).
Código principal
Búfer de entrada
El miembro AssociatedIrp.SystemBuffer apunta a una estructura de USB_NODE_CONNECTION_DRIVERKEY_NAME asignada por el usuario. En la entrada, el miembro ConnectionIndex de esta estructura contiene el número del puerto al que está conectado el dispositivo.
Longitud del búfer de entrada
Tamaño de una estructura de USB_NODE_CONNECTION_DRIVERKEY_NAME .
Búfer de salida
En la salida, el miembro DriverKeyName de la estructura de USB_NODE_CONNECTION_DRIVERKEY_NAME en AssociatedIrp.SystemBuffer contiene el nombre de clave de controlador asociado al dispositivo que está conectado al puerto indicado por ConnectionIndex.
El miembro ActualLength indica la longitud, en bytes, del nombre de clave del controlador. El miembro Parameters.DeviceIoControl.OutputBufferLength indica el tamaño, en bytes, de toda la estructura de USB_NODE_CONNECTION_DRIVERKEY_NAME .
Longitud del búfer de salida
Tamaño de una estructura de USB_NODE_CONNECTION_DRIVERKEY_NAME .
Bloque de estado
La pila USB establece Irp-IoStatus.Status> en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, la pila USB establece Estado en la condición de error adecuada, como STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES.
Si el autor de la llamada asigna un búfer de salida lo suficientemente grande como para contener todos los datos de salida, IoStatus.Information será igual al valor de ActualLength. Si el búfer de salida es lo suficientemente grande como para contener todos los datos de salida, IoStatus.Information será igual a sizeof(USB_NODE_CONNECTION_DRIVERKEY_NAME).
Requisitos
| Requisito | Valor |
|---|---|
| Header | usbioctl.h (incluya Usbioctl.h) |