EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE Rückruffunktion (ucxusbdevice.h)
Die Implementierung des Clienttreibers, die UCX aufruft, um Endpunkte im Controller zu konfigurieren.
Syntax
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE EvtUcxUsbdeviceEndpointsConfigure;
void EvtUcxUsbdeviceEndpointsConfigure(
[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 eine Struktur vom Typ ENDPOINTS_CONFIGURE Struktur.
Rückgabewert
Nichts
Bemerkungen
Der UCX-Clienttreiber registriert diese Rückruffunktion mit der USB-Hostcontrollererweiterung (UCX), indem die UcxUsbDeviceCreate-Methode aufgerufen wird.
Im Rückruf werden die Endpunkte, wie in der ENDPOINTS_CONFIGURE-Struktur beschrieben, vom Treiber programmiert oder deprogramiert.
Dieser Rückruf aktiviert oder deaktiviert den Standardendpunkt nicht. Der Status des Standardendpunkts ist an den Zustand des Geräts gebunden. Der Treiber implementiert Vorgänge in den EVT_UCX_USBDEVICE_DISABLE und EVT_UCX_USBDEVICE_ENABLE Rückruffunktionen.
Der Clienttreiber gibt den Abschlussstatus in Anforderungs-zurück. Der Treiber kann den WDFREQUEST asynchron abschließen.
Beispiele
VOID
UsbDevice_EvtUcxUsbDeviceEndpointsConfigure(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEndpointsConfigure");
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
...
endpointsConfigure = (PENDPOINTS_CONFIGURE)wdfRequestParams.Parameters.Others.Arg1;
...
WdfRequestComplete(Request, STATUS_SUCCESS);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | ucxusbdevice.h (include Ucxclass.h) |
| IRQL- | DISPATCH_LEVEL |