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 |
|---|---|
|
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) |