EVT_UCX_USBDEVICE_ENABLE Rückruffunktion (ucxusbdevice.h)

Die Implementierung des Clienttreibers, die UCX aufruft, um Programminformationen über das Gerät und seinen Standardsteuerungsendpunkt an den Controller zu senden.

Syntax

EVT_UCX_USBDEVICE_ENABLE EvtUcxUsbdeviceEnable;

VOID EvtUcxUsbdeviceEnable(
  [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

Eine Struktur vom Typ USBDEVICE_ENABLE.

Rückgabewert

Nichts

Bemerkungen

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

Um das Gerät in den gewünschten Zustand zu übertragen, kommuniziert der Hostcontrollertreiber mit der Hardware, um die Anforderung abzuschließen.

In dieser Rückruffunktion bereitet der Clienttreiber den Controller auf die Annahme und Planung von Übertragungen am Standardsteuerungsendpunkt für das USB-Gerät vor.

Nach Abschluss des Treibers wird der WDFREQUEST-Vorgang abgeschlossen.

Der Clienttreiber gibt den Abschlussstatus in Anforderungs-zurück. Der Treiber kann den WDFREQUEST asynchron abschließen.

Beispiele

VOID
UsbDevice_EvtUcxUsbDeviceEnable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)
    
{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEnable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceEnable = (PUSBDEVICE_ENABLE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Anforderungen

Siehe auch

UcxUsbDeviceCreate