EVT_UCX_USBDEVICE_UPDATE Rückruffunktion (ucxusbdevice.h)

Artikel
03/01/2024

Die Implementierung des Clienttreibers, die UCX aufruft, um Geräteeigenschaften zu aktualisieren.

Syntax

EVT_UCX_USBDEVICE_UPDATE EvtUcxUsbdeviceUpdate;

void EvtUcxUsbdeviceUpdate(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

Parameter

[in] UcxController

Ein Handle für den UCX-Controller, den der Clienttreiber bei einem vorherigen Aufruf der UcxControllerCreate-Methode empfangen hat.

[in] Request

Enthält die USBDEVICE_UPDATE-Struktur .

Rückgabewert

Keine

Bemerkungen

Der UCX-Clienttreiber registriert diese Rückruffunktion bei der USB-Hostcontrollererweiterung (UCX), indem die UcxUsbDeviceCreate-Methode aufgerufen wird .

Der Hostcontrollertreiber kommuniziert mit der Hardware, um Deskriptoren, LPM-Parameter, ob das Gerät ein Hub ist, und die maximale Exitlatenz nach Bedarf zu aktualisieren.

Der Clienttreiber gibt den Abschluss status in Anforderung zurück. Der Treiber kann wdFREQUEST asynchron abschließen.

Beispiele

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);
}