NdisDeregisterProtocol-Funktion (ndis.h)

  • Artikel

Hinweis NDIS 5. x ist veraltet und wird durch NDIS 6 ersetzt. x. Informationen zur Entwicklung neuer NDIS-Treiber finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber für NDIS 6. x, siehe Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

NdisDeregisterProtocol gibt die Ressourcen frei, die beim Namen des Treibers NdisRegisterProtocol zugewiesen wurden.

Syntax

void NdisDeregisterProtocol(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisProtocolHandle
);

Parameter

[out] Status

Zeiger auf eine vom Aufrufer bereitgestellte Variable, die auf NDIS_STATUS_SUCCESS festgelegt ist, wenn diese Funktion zurückgegeben wird.

[in] NdisProtocolHandle

Gibt das Handle an, das von NdisRegisterProtocol zurückgegeben wird, als der Treiber initialisiert wurde.

Rückgabewert

Keine

Bemerkungen

Registrierte Protokolltreiber rufen NdisDeregisterProtocol unter den folgenden Umständen auf:

  • Der Treiber hat bereits NdisRegisterProtocol erfolgreich aufgerufen, kann aber nicht an einen zugrunde liegenden NDIS-Treiber auf dem Computer gebunden werden.

  • Der Treiber wird entladen. Das heißt, die unload-Routine, die während der Initialisierung in ihrem Treiberobjekt eingerichtet wurde, wurde aufgerufen, oder die ProtocolUnbindAdapter-Funktion wurde aufgerufen, um die letzte verbleibende Bindung des Treibers freizugeben.

    Weitere Informationen zur Deload-Routine und anderen Standard-Kernelmodustreiberroutinen finden Sie unter Kernelmodustreiberkomponenten.

  • Das System wird heruntergefahren. Da der Treiber, bei dem es sich um ein Protokoll der höchsten Ebene handelt, bei der Initialisierung IoRegisterShutdownNotification genannt wurde, wurde die Shutdown-Routine aufgerufen.

    Weitere Informationen finden Sie unter IoRegisterShutdownNotification .

Wenn ein Protokoll über offene Bindungen verfügt, bewirkt der Aufruf von NdisDeregisterProtocol , dass NDIS die ProtocolUnbindAdapter-Funktion des Protokolls einmal für jede geöffnete Bindung aufruft. ProtocolUnbindAdapter ruft NdisCloseAdapter auf, um die Bindung zu schließen.

Wenn ausstehende Geöffnete (falls vorhanden) geschlossen wurden, gibt NdisDeregisterProtocol alle Filter frei, die sein Aufrufer eingerichtet hat, und gibt den Arbeitsspeicher frei, der NDIS zugewiesen wurde, um Bindungen und Filter für den Protokolltreiber nachzuverfolgen.

Anforderungen

Anforderung Wert
Header ndis.h (einschließlich Ndis.h)
Bibliothek Ndis.lib
IRQL PASSIVE_LEVEL

Weitere Informationen