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

IRP_MJ_DEVICE_CONTROL

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)

Consulte también

USB_NODE_CONNECTION_DRIVERKEY_NAME