NdisFRestartComplete-Funktion (ndis.h)
Ein Filtertreiber muss die NdisFRestartComplete--Funktion aufrufen, um einen Neustartvorgang abzuschließen, wenn der Treiber NDIS_STATUS_PENDING von seiner FilterRestart--Funktion zurückgegeben hat.
Syntax
void NdisFRestartComplete(
[in] NDIS_HANDLE NdisFilterHandle,
[in] NDIS_STATUS Status
);
Parameter
[in] NdisFilterHandle
Das NDIS-Handle, das dieses Filtermodul identifiziert. NDIS hat den Handle an den Filtertreiber in einem Aufruf der FilterAttach--Funktion übergeben.
[in] Status
Der endgültige Status des Neustartvorgangs. Die folgenden Statuswerte werden unterstützt:
NDIS_STATUS_SUCCESS
Der Treiber hat den Netzwerkdatenfluss erfolgreich neu gestartet.
NDIS_STATUS_RESOURCES
Fehler beim Neustart aufgrund unzureichender Ressourcen.
NDIS_STATUS_FAILURE
Der Treiber gibt NDIS_STATUS_FAILURE an, wenn keines der vorherigen Werte zutrifft. Der Treiber sollte die NdisWriteEventLogEntry- Funktion zusammen mit Parametern aufrufen, die den Grund für den Fehler angeben.
Rückgabewert
Nichts
Bemerkungen
NDIS ruft die FilterRestart--Funktion eines Filtertreibers auf, um eine Neustartanforderung für das Filtermodul zu initiieren. Das Filtermodul verbleibt im Zustand Neustarten Zustand, bis der Neustartvorgang abgeschlossen ist.
Ein ausstehender Neustartvorgang ist abgeschlossen, nachdem der Treiber die NdisFRestartComplete--Funktion aufruft. Das Filtermodul befindet sich im Zustand Wird ausgeführt, nachdem der Neustartvorgang abgeschlossen ist.
Ein Filtertreiber kann fortgesetzt werden, um empfangene Netzwerkdaten unmittelbar nach NDIS-Aufrufen FilterRestart- und bevor der Treiber NdisFRestartCompleteaufruft. Der Treiber sollte bereit sein, Sendeanforderungen zu akzeptieren, nachdem er den Neustartvorgang abgeschlossen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Filter_Driver_Function(ndis) |