EVT_UCX_USBDEVICE_DISABLE función de devolución de llamada (ucxusbdevice.h)
Implementación del controlador de cliente que UCX llama a los recursos del controlador de versión 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
Ninguno
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.
Mientras el dispositivo está deshabilitado, UCX no programa las 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 | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | ucxusbdevice.h (include Ucxclass.h) |
| irQL | DISPATCH_LEVEL |