NdisFRestartFilter-Funktion (ndis.h)

Ein Filtertreiber ruft die NdisFRestartFilter-Funktion auf, um NDIS anzufordern, einen Neustartvorgang für ein Filtermodul zu initiieren.

Syntax

NDIS_STATUS NdisFRestartFilter(
  [in] NDIS_HANDLE NdisFilterHandle
);

Parameter

[in] NdisFilterHandle

Das NDIS-Handle, das dieses Filtermodul identifiziert. NDIS hat das Handle in einem Aufruf der FilterAttach-Funktion an den Filtertreiber übergeben.

Rückgabewert

NdisFRestartFilter gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NdisFRestartFilter gibt NDIS_STATUS_SUCCESS zurück, wenn der Neustartvorgang gestartet wurde.
NDIS_STATUS_RESOURCES	Fehler bei NdisFRestartFilter aufgrund unzureichender Ressourcen.
NDIS_STATUS_FAILURE	NdisFRestartFilter gibt NDIS_STATUS_FAILURE zurück, wenn keiner der vorherigen Werte zutrifft.

Hinweise

Der Filtertreiber kann die Filtermodulattribute zur Laufzeit ändern, indem die NdisFRestartFilter-Funktion aufgerufen wird. NdisFRestartFilter plant eine Pause und dann einen Neustartvorgang für das angegebene Filtermodul.

Bevor NDIS das Filtermodul neu startet, ruft es die FilterSetModuleOptions-Funktion für das Filtermodul auf. Über seine FilterSetModuleOptions-Funktion kann der Filtertreiber die Datenhandler für dieses Filtermodul ändern, indem er die NdisSetOptionalHandlers-Funktion aufruft und einen neuen Satz von Handlern angibt.

Anforderungen

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

Weitere Informationen

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers