NdisMResetComplete-Makro (ndis.h)
Anmerkung
Verwenden Sie für NDIS 6.x (Windows Vista und höher) stattdessen die NdisMResetComplete-Funktion (NDIS 6.x).
Die NdisMResetComplete--Funktion gibt den endgültigen Status einer Zurücksetzungsanforderung zurück, für die der Miniporttreiber zuvor NDIS_STATUS_PENDING zurückgegeben hat.
Syntax
void NdisMResetComplete(
_M,
_S,
_A
);
Parameter
_M
Der Miniportadapterziehpunkt, den NDIS ursprünglich an die MiniportInitializeEx--Funktion übergeben hat.
_S
Der endgültige Status des Zurücksetzungsvorgangs wurde soeben abgeschlossen. Die Rückgabewerte entsprechen denen, die für die MINIPORT_RESET Rückruffunktionaufgeführt sind.
_A
Ein boolescher Wert, der TRUE ist, wenn NDIS für die Wiederherstellung der Einstellungen für Multicastadressen, Paketfilter und Aufgabenabladeinformationen verantwortlich ist. In diesem Fall ist der Miniporttreiber für die Wiederherstellung der restlichen Konfigurationseinstellungen für die Netzwerkschnittstellenkarte (NIC) verantwortlich, auf die von MiniportAdapterHandle verwiesen wird.
Wenn AddressingReset-FALSEist, ist der Miniporttreiber für die Wiederherstellung aller Konfigurationseinstellungen für die NIC verantwortlich.
Weitere Informationen finden Sie unter Hardwarezurücksetzung.
Rückgabewert
Nichts
Bemerkungen
Wenn die MiniportResetEx-Funktion NDIS_STATUS_PENDING zurückgibt, muss der Miniporttreiber NdisMResetComplete- aufrufen, wenn der Rücksetzungsvorgang abgeschlossen ist.
Protokolltreiber können in NDIS 6.0 und höheren Versionen keinen Zurücksetzungsvorgang initiieren.
Einige NICs verlieren alle Multicastadressen-, Paketfilter- oder funktionalen Adressinformationen, wenn ein vorläufiges Zurücksetzen ausgegeben wird. Der Treiber einer solchen NIC legt AddressingReset- auf TRUE- fest, wenn er NdisMResetComplete-aufruft, wodurch NDIS seine MiniportOidRequest--Funktion aufruft, um den Adressierungszustand wiederherzustellen. Weitere Informationen finden Sie unter Hardwarezurücksetzung.
Ein Miniporttreiber muss jede Drehsperre freigeben, die sie hält, bevor NdisMResetCompleteaufgerufen wird.
In NDIS 6.0 und höher müssen Anrufer von NdisMResetComplete- unter IRQL <= DISPATCH_LEVEL ausgeführt werden. Andernfalls müssen Aufrufer von NdisMResetComplete- unter IRQL = DISPATCH_LEVEL ausgeführt werden.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Unterstützt in NDIS 5.1 und NDIS 6.0 und höher. Informationen zu NDIS 5.1-Treibern finden Sie unter NdisMResetComplete (NDIS 5.1). |
Zielplattform- | Universal |
Header- | ndis.h (include Ndis.h) |
Library | Ndis.lib |
IRQL- | DISPATCH_LEVEL |
DDI-Complianceregeln | Irql_Miniport_Driver_Function(ndis) |