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

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES