NetDeviceRequestReset-Funktion (netadaptercx.h)
Die NetDeviceRequestReset--Funktion löst das NetAdapterCx-Framework aus, um den Zurücksetzungsvorgang 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 WdfDeviceCreateerstellt hat.
Rückgabewert
Nichts
Bemerkungen
Ein Clienttreiber ruft NetDeviceRequestReset- auf, wenn ein Gerätefehler erkannt wird. NetDeviceRequestReset sofort an den Clienttreiber zurück. Der Treiber kann nur NetDeviceRequestReset- bei PASSIVE_LEVEL aufrufen.
NetDeviceRequestReset ist nicht blockiert und wird sofort an den Clienttreiber zurückgegeben. Der Clienttreiber sollte alle laufenden Aufträge abbrechen, die auf das aktuell fehlgeschlagene Gerät zugreifen.
Es wird empfohlen, dass Clienttreiber eine NET_DEVICE_RESET_CAPABILITIES Struktur einrichten, um während des Zurücksetzungs- und Wiederherstellungsvorgangs für das Gerät aussagekräftige Rücksetzdiagnosen zu sammeln. Weitere Informationen zum Sammeln der Zurücksetzungsdiagnose finden Sie unter Registrieren des optionalen Diagnoseauflistungsrückrufs.
NetDeviceRequestReset- gilt nur für PCIe-basierte NIC-Geräte. Folgen Sie für USB-basierte NIC-Geräte dem in How to recover from USB pipe errorsbeschriebenen Prozess.
Wenn auf dem Gerät ein nicht wiederherstellbarer Hardware- oder Softwarefehler auftritt, kann der Clienttreiber die WdfDeviceSetFailed--Funktion verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11 |
| mindestens unterstützte Server- | Windows Server 2022 |
| Mindest-UMDF-Version | 2.33 |
| Header- | netadaptercx.h (include netadaptercx.h) |
| IRQL- | PASSIVE_LEVEL |
Siehe auch
Wiederherstellen einer nicht reagierenden NIC mit NetAdapterCx PLDR-