IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Artículo
08/07/2023

Esta solicitud se registra para recibir notificaciones sobre los cambios en las características de transporte.

Código principal

Búfer de entrada y salida

El miembro AssociatedIrp.SystemBuffer es un puntero a una estructura de USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION . En la entrada, el controlador cliente puede especificar el tipo de cambios de notificación en los que el controlador está interesado estableciendo las marcas en el miembro ChangeNotificationInputFlags .

En la salida, la estructura se rellena con el identificador de registro y los valores iniciales de las características de transporte.

Longitud del búfer de entrada y salida

Tamaño de la estructura USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION .

Bloque de estado

Irp->IoStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, Status indica la condición de error adecuada como código NTSTATUS .

Comentarios

Las características de transporte de los medios MA-USB pueden variar significativamente con el tiempo. Si el buzón de cliente está interesado en conocer la información más reciente en todo momento, el controlador debe registrarse para recibir notificaciones enviando la solicitud.

Esta solicitud se puede enviar mediante una aplicación en modo de usuario, un controlador UMDF o un controlador KMDF. La pila del controlador USB comprueba si hay un identificador de registro obsoleto y incorrecto. Si la solicitud se recibe en un identificador antes del registro y después de anular el registro, la pila de controladores produce un error en la solicitud.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709
Servidor mínimo compatible	Windows Server 2016
Encabezado	usbioctl.h
IRQL	<=DISPATCH_LEVEL