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 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) |