EVT_UCX_USBDEVICE_DISABLE Rückruffunktion (ucxusbdevice.h)

Die Implementierung des Clienttreibers, die UCX für Releasecontrollerressourcen aufruft, 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 bei einem vorherigen Aufruf der UcxControllerCreate-Methode empfangen hat.

[in] Request

Eine Struktur vom Typ USBDEVICE_DISABLE.

Rückgabewert

Keine

Bemerkungen

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

Wenn der Clienttreiber Controllerressourcen freigegeben hat, wird WDFREQUEST abgeschlossen. Nach Abschluss ist 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 versetzen, kommuniziert der Hostcontrollertreiber mit der Hardware, um die Anforderung abzuschließen.

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

Weitere Informationen

UcxUsbDeviceErstellen