Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 aus einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParametersabgerufen wurde.
Rückgabewert
WdfUsbTargetDeviceResetPortSynchronously gibt den Abschlussstatuswert des USB-E/A-Ziels 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-Wertezurückgeben.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Die WdfUsbTargetDeviceResetPortSynchronously Methode setzt den USB-Port 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 E/A-Zielwarteschlange verbleiben. Der Treiber darf erst zusätzliche E/A-Anforderungen an das E/A-Ziel senden, wenn WdfUsbTargetDeviceResetPortSynchronously zurückgegeben wird.
Der Treiber muss WdfIoTargetStop- aufrufen, bevor er WdfUsbTargetDeviceResetPortSynchronouslyaufruft. Nachdem WdfUsbTargetDeviceResetPortSynchronously zurückgegeben wurde, kann der Treiber WdfIoTargetStartaufrufen.
Nach einem erfolgreichen Rücksetzungsvorgang wählt der Bustreiber die Konfiguration und alle alternativen Schnittstelleneinstellungen wieder aus, die das Gerät vor dem Zurücksetzen hatte.
Weitere Informationen zu den 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- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfusb.h (include Wdfusb.h) |
| Library | 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) |