NdisDeregisterProtocolDriver-Funktion (ndis.h)

Ein Protokolltreiber ruft die NdisDeregisterProtocolDriver-Funktion auf, um die Ressourcen freizugeben, die NDIS zugewiesen hat, als der Treiber die NdisRegisterProtocolDriver-Funktion .

Syntax

void NdisDeregisterProtocolDriver(
  [in] NDIS_HANDLE NdisProtocolHandle
);

Parameter

[in] NdisProtocolHandle

Der vom NdisRegisterProtocolDriver-Funktion .

Rückgabewert

Keine

Bemerkungen

Registrierte Protokolltreiber rufen in der Regel NdisDeregisterProtocolDriver auf, wenn die Entladen-Routine des Treibers aufgerufen wurde oder nachdem Fehler in der DriverEntry-Routine aufgetreten sind. Protokolltreiber dürfen NdisDeregisterProtocolDriver nicht von einem Einstiegspunkt aufrufen, der von NDIS aufgerufen wird. Das Aufrufen von NdisDeregisterProtocolDriver von einem solchen Einstiegspunkt aus kann zu einem Deadlock führen.

Wenn ein Protokolltreiber über offene Bindungen verfügt, bewirkt sein Aufruf von NdisDeregisterProtocolDriver , dass NDIS den Protokolltreiber aufruft. ProtocolUnbindAdapterEx-Funktion einmal für jede geöffnete Bindung. NDIS ruft ProtocolUnbindAdapterEx im Kontext des NdisDeregisterProtocolDriver-Aufrufs auf.

Nachdem alle ausstehenden Bindungen geschlossen wurden, gibt NdisDeregisterProtocolDriver alle Ressourcen frei, die NDIS für die Nachverfolgung von Bindungen und Filtern für den Protokolltreiber zugewiesen hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Protocol_Driver_Function(ndis)

Weitere Informationen

DriverEntry

NdisRegisterProtocolDriver

ProtocolUnbindAdapterEx

Entladen