NdisMRestartComplete-Funktion (ndis.h)
Ein Miniporttreiber muss die NdisMRestartComplete-funktion aufrufen, um einen Neustartvorgang abzuschließen, wenn der Treiber NDIS_STATUS_PENDING von seiner MiniportRestart--Funktion zurückgegeben hat.
Syntax
void NdisMRestartComplete(
[in] IN NDIS_HANDLE MiniportAdapterHandle,
[in] IN NDIS_STATUS Status
);
Parameter
[in] MiniportAdapterHandle
Der Miniportadapterziehpunkt, den NDIS an den MiniportAdapterHandle Parameter des Parameters "MiniportAdapterHandle" übergeben hat MiniportInitializeEx Funktion.
[in] Status
Der endgültige Status des Neustartvorgangs. Die folgenden Statuswerte werden unterstützt:
NDIS_STATUS_SUCCESS
Der Treiber hat den Netzwerkdatenfluss erfolgreich über den Miniportadapter 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 NdisWriteErrorLogEntry- Funktion mit Parametern aufrufen, die den Grund für den Fehler angeben.
Rückgabewert
Nichts
Bemerkungen
Der bei MiniportAdapterHandle angegebene MiniportAdapterHandle- wechselt in den Zustand Neustarten, wenn NDIS die MiniportRestart--Funktion aufruft.
Nachdem der Miniporttreiber die Sende- und Empfangsvorgänge für den Miniportadapter erfolgreich neu gestartet hat, muss der Treiber den ausstehenden Neustartvorgang abschließen. Der ausstehende Neustartvorgang ist abgeschlossen, nachdem der Treiber NdisMRestartCompleteaufgerufen hat. Der Miniportadapter befindet sich im Zustand "Ausführen", nachdem der Neustartvorgang abgeschlossen ist.
Ein Miniporttreiber kann fortgesetzt werden, um empfangene Pakete unmittelbar nach NDIS-Aufrufen MiniportRestart- und bevor der Treiber NdisMRestartCompleteaufruft. Der Treiber sollte bereit sein, Sendeanforderungen zu akzeptieren, nachdem er die Neustartanforderung abgeschlossen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miniport_Driver_Function(ndis) |