NdisMResetComplete-Makro (NDIS 6.x)
Die NdisMResetComplete-Funktion gibt die letzte 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
Das Miniportadapterhandle, das NDIS ursprünglich an die MiniportInitializeEx-Funktion übergeben hat.
Status
Der letzte status des soeben abgeschlossenen Zurücksetzungsvorgangs. Die Rückgabewerte sind identisch mit denen, die für die MINIPORT_RESET-Rückruffunktion aufgeführt sind.
AddressingReset
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), auf die von MiniportAdapterHandle verwiesen wird, verantwortlich.
Wenn AddressingResetauf FALSE festgelegt 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 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 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) | Windows Vista und höher |
| Kopfzeile | ndis.h |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miniport_Driver_Function(ndis) |