NdisMResetComplete-Makro (ndis.h)
Hinweis
Verwenden Sie für NDIS 6.x (Windows Vista und höher) stattdessen die Funktion NdisMResetComplete (NDIS 6.x).
Die Funktion NdisMResetComplete gibt den letzten 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
Das Miniportadapterhandle, das NDIS ursprünglich an die Funktion MiniportInitializeEx übergeben hat.
_S
Der letzte status des Zurücksetzungsvorgangs wurde gerade abgeschlossen. Die Rückgabewerte sind mit denen identisch, die für die MINIPORT_RESET Rückruffunktion aufgeführt sind.
_A
Ein boolescher Wert, der TRUE ist, wenn NDIS für die Wiederherstellung der Einstellungen für Multicastadressen, Paketfilter und Aufgabenauslagerungsinformationen verantwortlich ist. In diesem Fall ist der Miniporttreiber für die Wiederherstellung der restlichen Konfigurationseinstellungen für die Netzwerkschnittstelle Karte (NIC) verantwortlich, auf die von MiniportAdapterHandle verwiesen wird.
Wenn AddressingResetFALSE ist, ist der Miniporttreiber für die Wiederherstellung aller Konfigurationseinstellungen für die NIC verantwortlich.
Weitere Informationen finden Sie unter Hardwarezurücksetzung.
Rückgabewert
Keine
Bemerkungen
Wenn die MiniportResetEx-Funktion NDIS_STATUS_PENDING zurückgibt, muss der Miniporttreiber NdisMResetComplete aufrufen, wenn er den Zurücksetzungsvorgang abgeschlossen hat.
Protokolltreiber können in NDIS 6.0 und höheren Versionen keinen Zurücksetzungsvorgang initiieren.
Einige NICs verlieren alle Informationen zu Multicastadressen, Paketfiltern oder funktionalen Adressen, 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 vor dem Aufrufen von NdisMResetComplete jede spin-Sperre freigeben, die er hält.
In NDIS 6.0 und höher müssen Aufrufer 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 |
|---|---|
| Unterstützte Mindestversion (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 | Universell |
| Header | ndis.h (einschließlich Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miniport_Driver_Function(ndis) |