EVT_UCX_USBDEVICE_UPDATE Rückruffunktion (ucxusbdevice.h)

Artikel
02/07/2025

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 in einem vorherigen Aufruf der UcxControllerCreate-Methode empfangen hat.

[in] Request

Enthält die USBDEVICE_UPDATE Struktur.

Rückgabewert

Nichts

Bemerkungen

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

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

Der Clienttreiber gibt den Abschlussstatus in Anforderungs-zurück. Der Treiber kann den 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);
}