UdecxWdfDeviceNeedsReset-Funktion (udecxwdfdevice.h)

  • Artikel

Informiert die USB-Geräteemulationsklassenerweiterung (UdeCx), dass das Gerät einen Zurücksetzungsvorgang benötigt.

Syntax

NTSTATUS UdecxWdfDeviceNeedsReset(
  [In] WDFDEVICE                   UdeWdfDevice,
  [In] UDECX_WDF_DEVICE_RESET_TYPE ResetType
);

Parameter

[In] UdeWdfDevice

Ein Handle für ein Frameworkgeräteobjekt, das das USB-Gerät darstellt. Der Clienttreiber hat dieses Objekt im vorherigen Aufruf von UdecxWdfDeviceAddUsbDeviceEmulation initialisiert.

[In] ResetType

Ein UDECX_WDF_DEVICE_RESET_TYPE-Type-Wert, der den Typ des Zurücksetzens angibt. Nur UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset wird zu diesem Zeitpunkt unterstützt.

Rückgabewert

Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Wenn ein vorhandener Zurücksetzungsvorgang ausgeführt wird, schlägt die Funktion mit einem STATUS_DEVICE_BUSY Fehler fehl. Beachten Sie, dass derzeit nur UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset unterstützt wird. UdecxWdfDeviceResetAttemptFunctionLevelDeviceReset wird nicht unterstützt.

Anforderungen

Anforderung Wert
KMDF-Mindestversion 1,27
UMDF-Mindestversion –
Kopfzeile udecxwdfdevice.h (einschließlich Udecx.h)
Bibliothek Udecxstub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

UDECX_WDF_DEVICE_RESET_TYPE