EVT_UCX_USBDEVICE_ENABLE Rückruffunktion (ucxusbdevice.h)

  • Artikel

Die Implementierung des Clienttreibers, die UCX aufruft, um Informationen zum Gerät und dessen Standardsteuerungsendpunkt in den Controller zu programmieren.

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

[in] Request

Eine Struktur vom Typ USBDEVICE_ENABLE.

Rückgabewert

Keine

Bemerkungen

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

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

In dieser Rückruffunktion bereitet der Clienttreiber den Controller darauf vor, Übertragungen auf dem Standardsteuerungsendpunkt für das USB-Gerät zu akzeptieren und zu planen.

Wenn der Treiber fertig ist, schließt er die WDFREQUEST ab.

Der Clienttreiber gibt den Abschluss status in Anforderung zurück. Der Treiber kann 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

Anforderung Wert
Zielplattform Windows
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile ucxusbdevice.h (include Ucxclass.h)
IRQL DISPATCH_LEVEL

Weitere Informationen

UcxUsbDeviceCreate