Freigeben über

NdisFRestartComplete-Funktion (ndis.h)

  • Artikel

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 in einem Aufruf der FilterAttach-Funktion an den Filtertreiber übergeben.

[in] Status

Der letzte status des Neustartvorgangs. Die folgenden status Werte 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 keiner der vorherigen Werte zutrifft. Der Treiber sollte die NdisWriteEventLogEntry-Funktion zusammen mit Parametern aufrufen, die den Grund für den Fehler angeben.

Rückgabewert

Keine

Bemerkungen

NDIS ruft die FilterRestart-Funktion eines Filtertreibers auf, um eine Neustartanforderung für das Filtermodul zu initiieren. Das Filtermodul bleibt im Status Neustarten , bis der Neustartvorgang abgeschlossen ist.

Ein ausstehender Neustartvorgang ist abgeschlossen, nachdem der Treiber die NdisFRestartComplete-Funktion aufgerufen hat . Das Filtermodul befindet sich nach Abschluss des Neustartvorgangs im Status "Ausgeführt ".

Ein Filtertreiber kann fortgesetzt werden, der angibt, dass empfangene Netzwerkdaten unmittelbar nach dem Aufruf von NDIS FilterRestart und bevor der Treiber NdisFRestartComplete aufruft. Der Treiber sollte bereit sein, Sendeanforderungen zu akzeptieren, nachdem er den Neustartvorgang abgeschlossen hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Zielplattform Desktop
Kopfzeile ndis.h (einschließlich Ndis.h)
Bibliothek Ndis.lib
IRQL PASSIVE_LEVEL
DDI-Complianceregeln Irql_Filter_Driver_Function(ndis)

Weitere Informationen

FilterAttach

FilterRestart

NdisWriteEventLogEntry