NdisMResetComplete-Makro (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(
NDIS_HANDLE MiniportAdapterHandle,
NDIS_STATUS Status,
BOOLEAN AddressingReset
);
Parameter
MiniportAdapterHandle
Der Miniportadapterziehpunkt, den NDIS ursprünglich an die MiniportInitializeEx--Funktion übergeben hat.
Status
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.
AddressingReset
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- | Windows Vista und höher |
| Header- | ndis.h |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miniport_Driver_Function(ndis) |