NetDeviceRequestReset-Funktion (netadaptercx.h)
Die NetDeviceRequestReset-Funktion löst das NetAdapterCx-Framework aus, um den Vorgang zum Zurücksetzen von Geräten auf Plattformebene auszuführen, mit dem ein nicht reagierendes NIC-Gerät wiederhergestellt wird.
Syntax
void NetDeviceRequestReset(
[_In_] WDFDEVICE Device
);
Parameter
[_In_] Device
Das WDFDEVICE-Objekt, das der Clienttreiber zuvor mit einem Aufruf von WdfDeviceCreate erstellt hat.
Rückgabewert
Keine
Bemerkungen
Ein Clienttreiber ruft NetDeviceRequestReset auf, wenn er Gerätefehler erkennt. NetDeviceRequestReset kehrt sofort an den Clienttreiber zurück. Der Treiber kann netDeviceRequestReset nur bei PASSIVE_LEVEL aufrufen.
NetDeviceRequestReset ist nicht blockiert und kehrt sofort an den Clienttreiber zurück. Der Clienttreiber sollte alle laufenden Aufträge abbrechen, die auf das aktuell ausgefallene Gerät zugreifen.
Es wird empfohlen, dass Clienttreiber eine NET_DEVICE_RESET_CAPABILITIES-Struktur einrichten, um während des Gerätezurücksetzungs- und -wiederherstellungsvorgangs sinnvolle zurückgesetzte Diagnose zu sammeln. Weitere Informationen zum Sammeln von zurückgesetzten Diagnose finden Sie unter Registrieren des optionalen Diagnose Sammlungsrückrufs.
NetDeviceRequestReset gilt nur für PCIe-basierte NIC-Geräte. Führen Sie für USB-basierte NIC-Geräte den unter Wiederherstellen von USB-Pipefehlern beschriebenen Prozess aus.
Wenn auf dem Gerät ein nicht wiederherstellbarer Hardware- oder Softwarefehler auftritt, kann der Clienttreiber die Funktion WdfDeviceSetFailed verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11 |
| Unterstützte Mindestversion (Server) | Windows Server 2022 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netadaptercx.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Weitere Informationen
Wiederherstellen einer nicht reagierenden NIC mit NetAdapterCx PLDR