EVT_UCX_USBDEVICE_DISABLE Rückruffunktion (ucxusbdevice.h)

Die Implementierung des Clienttreibers, die UCX aufruft, um Controllerressourcen freizugeben, die dem Gerät und seinem Standardendpunkt zugeordnet sind.

Syntax

EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;

VOID EvtUcxUsbdeviceDisable(
  [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_DISABLE.

Rückgabewert

Nichts

Bemerkungen

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

Wenn der Clienttreiber Controllerressourcen freigegeben hat, wird der WDFREQUEST-Vorgang abgeschlossen. Nach Abschluss wird die einzige Rückruffunktion, die UCX aufruft, die auf dieses USB-Gerät verweist, EVT_UCX_USBDEVICE_ENABLE.

Während das Gerät deaktiviert ist, plant UCX keine Übertragungen dafür.

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

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

Beispiele

VOID
UsbDevice_EvtUcxUsbDeviceDisable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)


{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceDisable = (PUSBDEVICE_DISABLE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Anforderungen

Siehe auch

UcxUsbDeviceCreate