NdisMRestartComplete-Funktion (ndis.h)

Artikel
02/29/2024

Ein Miniporttreiber muss die NdisMRestartComplete-Funktion aufrufen, um einen Neustartvorgang abzuschließen, wenn der Treiber NDIS_STATUS_PENDING von seiner MiniportRestart-Funktion zurückgegeben hat.

Syntax

void NdisMRestartComplete(
  [in] IN NDIS_HANDLE MiniportAdapterHandle,
  [in] IN NDIS_STATUS Status
);

Parameter

[in] MiniportAdapterHandle

Das Miniportadapterhandle, das NDIS an den MiniportAdapterHandle-Parameter des MiniportInitializeEx-Funktion .

[in] Status

Die letzte status des Neustartvorgangs. Die folgenden status Werte werden unterstützt:

NDIS_STATUS_SUCCESS

Der Treiber hat den Netzwerkdatenfluss über den Miniportadapter erfolgreich neu gestartet.

NDIS_STATUS_RESOURCES

Fehler beim Neustart aufgrund unzureichender Ressourcen.

NDIS_STATUS_FAILURE

Der Treiber gibt NDIS_STATUS_FAILURE an, wenn keiner der vorherigen Werte zutrifft. Der Treiber sollte die NdisWriteErrorLogEntry-Funktion mit Parametern aufrufen, die den Grund für den Fehler angeben.

Rückgabewert

Keine

Bemerkungen

Der unter MiniportAdapterHandle angegebene Miniportadapter wechselt in den Neustartzustand , wenn NDIS die MiniportRestart-Funktion aufruft .

Nachdem der Miniporttreiber die Sende- und Empfangsvorgänge für den Miniportadapter erfolgreich neu gestartet hat, muss der Treiber den ausstehenden Neustartvorgang abschließen. Der Ausstehende Neustartvorgang ist abgeschlossen, nachdem der Treiber NdisMRestartComplete aufgerufen hat. Der Miniportadapter befindet sich nach Abschluss des Neustartvorgangs im Status Wird ausgeführt.

Ein Miniporttreiber kann sofort nach dem Aufruf von MiniportRestart und vor dem Aufruf von NdisMRestartComplete durch den Treiber die empfangenen Pakete fortsetzen. Der Treiber sollte bereit sein, Sendeanforderungen zu akzeptieren, nachdem er die Neustartanforderung abgeschlossen hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Miniport_Driver_Function(ndis)