WdfUsbTargetDeviceResetPortSynchronously-Funktion (wdfusb.h)

[Gilt für KMDF und UMDF]

Die WdfUsbTargetDeviceResetPortSynchronously-Methode setzt den USB-Anschluss zurück, der dem angegebenen USB-Gerät zugeordnet ist.

Syntax

NTSTATUS WdfUsbTargetDeviceResetPortSynchronously(
  [in] WDFUSBDEVICE UsbDevice
);

Parameter

[in] UsbDevice

Ein Handle für ein USB-Geräteobjekt, das von einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParameters abgerufen wurde.

Rückgabewert

WdfUsbTargetDeviceResetPortSynchronously gibt die Vervollständigung des USB-E/A-Ziels status Wert zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
STATUS_INVALID_DEVICE_REQUEST	Die IRQL des Aufrufers war ungültig.

 

Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Die WdfUsbTargetDeviceResetPortSynchronously-Methode setzt den USB-Anschluss zurück, indem eine IOCTL_INTERNAL_USB_RESET_PORT-Anforderung gesendet wird.

Bevor das Framework den USB-Port des E/A-Ziels zurücksetzt, werden alle E/A-Anforderungen abgebrochen, die in der Warteschlange des E/A-Ziels verbleiben. Der Treiber darf keine zusätzlichen E/A-Anforderungen an das E/A-Ziel senden, bis WdfUsbTargetDeviceResetPortSynchronously zurückgibt.

Der Treiber muss WdfIoTargetStop aufrufen, bevor er WdfUsbTargetDeviceResetPortSynchronously aufruft. Nachdem WdfUsbTargetDeviceResetPortSynchronously zurückgegeben wurde , kann der Treiber WdfIoTargetStart aufrufen.

Nach einem erfolgreichen Zurücksetzen wählt der Bustreiber die Konfiguration und alle alternativen Schnittstelleneinstellungen erneut aus, die das Gerät vor dem Zurücksetzungsvorgang hatte.

Weitere Informationen zur WdfUsbTargetDeviceResetPortSynchronously-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.

Beispiele

Im folgenden Codebeispiel wird der USB-Anschluss eines angegebenen Geräts zurückgesetzt.

NTSTATUS status;

status = WdfUsbTargetDeviceResetPortSynchronously(UsbDevice);

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfusb.h (einschließlich Wdfusb.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfUsbTargetDeviceCreateWithParameters