Share via


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

Consulte también

UcxUsbDeviceCreate