EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE función de devolución de llamada (udecxusbdevice.h)
La extensión de clase de emulación de dispositivo USB (UdeCx) invoca esta función de devolución de llamada para cambiar la configuración seleccionando una configuración alternativa, deshabilitando los puntos de conexión actuales o agregando puntos de conexión dinámicos.
Sintaxis
EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;
void EvtUdecxUsbDeviceEndpointsConfigure(
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] WDFREQUEST Request,
[in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}
Parámetros
[in] UdecxUsbDevice
Identificador del objeto de dispositivo UDE. El controlador cliente creó este objeto en una llamada anterior a UdecxUsbDeviceCreate.
[in] Request
Identificador de un objeto de solicitud de marco que representa la solicitud.
[in] Params
Puntero a una estructura de UDECX_ENDPOINTS_CONFIGURE_PARAMS que describe las opciones de configuración.
Valor devuelto
None
Observaciones
El controlador cliente registró esta función de devolución de llamada en una llamada anterior a UdecxUsbDeviceInitSetStateChangeCallbacks proporcionando un puntero de función a su implementación.
La extensión de clase invoca esta función de devolución de llamada para solicitar al controlador cliente que configure uno o varios puntos de conexión nuevos en hardware, o informa al controlador cuando uno o varios puntos de conexión existentes ya no se usan.
Después de crear puntos de conexión, para cada nuevo punto de conexión, el controlador de cliente debe llamar a UdecxUsbEndpointSetWdfIoQueue antes de completar la solicitud.
Después de liberar puntos de conexión, el controlador cliente no debe usar objetos de cola de marco asociados a los puntos de conexión. La extensión de clase considera esas colas como purgadas para evitar solicitudes futuras.
La extensión de clase también puede solicitar un nuevo valor de configuración o una configuración alternativa a través de esta devolución de llamada.
Esta llamada es asincrónica. El controlador cliente debe indicar la finalización con el estado completando la solicitud pasada por la extensión de clase.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10 |
| Servidor mínimo compatible | Windows Server 2016 |
| Plataforma de destino | Windows |
| Versión mínima de KMDF | 1.15 |
| Encabezado | udecxusbdevice.h (incluya Udecx.h) |
| IRQL | <=DISPATCH_LEVEL |