EVT_UCX_USBDEVICE_UPDATE función de devolución de llamada (ucxusbdevice.h)

Artículo
03/05/2024

Implementación del controlador cliente a la que UCX llama para actualizar las propiedades del dispositivo.

Sintaxis

EVT_UCX_USBDEVICE_UPDATE EvtUcxUsbdeviceUpdate;

void EvtUcxUsbdeviceUpdate(
  [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

Contiene la estructura USBDEVICE_UPDATE .

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 .

El controlador del controlador de host se comunica con el hardware para actualizar descriptores, parámetros LPM, si el dispositivo es un concentrador y la latencia de salida máxima, según sea necesario.

El controlador cliente devuelve el estado de finalización en Solicitud. El controlador puede completar WDFREQUEST de forma asincrónica.

Ejemplos

VOID
UsbDevice_EvtUcxUsbDeviceUpdate(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceUpdate");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceUpdate = (PUSBDEVICE_UPDATE)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 (incluye Ucxclass.h)
IRQL	DISPATCH_LEVEL