EVT_UCX_USBDEVICE_DISABLE función de devolución de llamada (ucxusbdevice.h)
La implementación del controlador de cliente que UCX llama a para liberar los recursos del controlador asociados al dispositivo y a su punto de conexión predeterminado.
Sintaxis
EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;
void EvtUcxUsbdeviceDisable(
[in] UCXCONTROLLER UcxController,
[in] WDFREQUEST Request
)
{...}
Parámetros
[in] UcxController
Identificador del controlador UCX que el controlador cliente recibió en una llamada anterior al método UcxControllerCreate .
[in] Request
Estructura de tipo USBDEVICE_DISABLE.
Valor devuelto
None
Observaciones
El controlador cliente UCX registra esta función de devolución de llamada con la extensión del controlador de host USB (UCX) llamando al método UcxUsbDeviceCreate .
Cuando el controlador de cliente ha liberado los recursos del controlador, completa el WDFREQUEST. Después de la finalización, la única función de devolución de llamada a la que llama UCX que hace referencia a este dispositivo USB es EVT_UCX_USBDEVICE_ENABLE.
Aunque el dispositivo está deshabilitado, UCX no programa transferencias para él.
Para realizar la transición del dispositivo al estado deseado, el controlador del host se comunica con el hardware para completar la solicitud.
El controlador cliente devuelve el estado de finalización en Solicitud. El controlador puede completar WDFREQUEST de forma asincrónica.
Ejemplos
VOID
UsbDevice_EvtUcxUsbDeviceDisable(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
usbDeviceDisable = (PUSBDEVICE_DISABLE)wdfRequestParams.Parameters.Others.Arg1;
...
WdfRequestComplete(Request, STATUS_SUCCESS);
}
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | ucxusbdevice.h (include Ucxclass.h) |
| IRQL | DISPATCH_LEVEL |