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 |
|---|---|
|
NdisFRestartFilter gibt NDIS_STATUS_SUCCESS zurück, wenn der Neustartvorgang gestartet wurde. |
|
Fehler bei NdisFRestartFilter aufgrund unzureichender Ressourcen. |
|
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) |