UfxDeviceNotifyReset-Funktion (ufxclient.h)

Benachrichtigt UFX über ein USB-Busrücksetzungsereignis.

Syntax

void UfxDeviceNotifyReset(
  [in] UFXDEVICE        UfxDevice,
  [in] USB_DEVICE_SPEED DeviceSpeed
);

Parameter

[in] UfxDevice

Ein Handle für ein UFX-Geräteobjekt, das der Treiber durch Aufrufen von UfxDeviceCreate erstellt hat.

[in] DeviceSpeed

Enthält einen Wert vom Typ USB_DEVICE_SPEED , der die Geschwindigkeit des Geräts angibt.

Rückgabewert

Keine

Bemerkungen

Der Clienttreiber ruft UfxDeviceNotifyReset auf, wenn er ein Busrücksetzungsereignis empfängt. Alle nicht standardmäßigen Endpunkte sollten deaktiviert und der Standardendpunkt zurückgesetzt werden. Das Gerät wechselt in den Standardzustand.

Der Clienttreiber ruft in der Regel UfxDeviceNotifyReset über seine EvtInterruptDpc-Rückruffunktion auf. Das folgende Beispiel zeigt, wie ein Zurücksetzungsereignis behandelt wird.

VOID
HandleUsbConnect (
    WDFDEVICE WdfDevice
    )
/*++

Routine Description:

    Handles a connect event from the controller.

Arguments:

    WDfDevice - WDFDEVICE object representing the controller.

--*/
{
    PCONTROLLER_CONTEXT ControllerContext;
    USB_DEVICE_SPEED DeviceSpeed;

    TraceEntry();

    ControllerContext = DeviceGetControllerContext(WdfDevice);

    //
    // Read the device speed.
    //

    //
    // #### TODO: Add code to read device speed from the controller ####
    //
    
    // Sample will assume SuperSpeed operation for illustration purposes
    DeviceSpeed = UsbSuperSpeed;
    
    //
    // #### TODO: Add any code needed to configure the controller after connect has occurred ####
    //


    ControllerContext->Speed = DeviceSpeed;
    TraceInformation("Connected Speed is %d!", DeviceSpeed);

    //
    // Notify UFX about reset, which will take care of updating 
    // Max Packet Size for EP0 by calling descriptor update.
    //
    UfxDeviceNotifyReset(ControllerContext->UfxDevice, DeviceSpeed);

    ControllerContext->Connect = TRUE;

    TraceExit();
}

Anforderungen