EVT_UCX_USBDEVICE_ENABLE Rückruffunktion (ucxusbdevice.h)
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 |