UdecxWdfDeviceNeedsReset-Funktion (udecxwdfdevice.h)
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 ein 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 |