Freigeben über

NdisDeregisterProtocol-Funktion (ndis.h)

Hinweis NDIS 5. x ist veraltet und wird von NDIS 6 ersetzt. x. Informationen zur neuen NDIS-Treiberentwicklung finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber auf NDIS 6. xfinden Sie unter Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

NdisDeregisterProtocol gibt die Ressourcen frei, die dem Treiber zugeordnet werden, wenn NdisRegisterProtocolaufgerufen wird.

Syntax

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

Parameter

[out] Status

Zeiger auf eine vom Aufrufer bereitgestellte Variable, die für die Rückgabe dieser Funktion auf NDIS_STATUS_SUCCESS festgelegt ist.

[in] NdisProtocolHandle

Gibt das von NdisRegisterProtocol zurückgegebene Handle an, wenn der Treiber initialisiert wurde.

Rückgabewert

Nichts

Bemerkungen

Registrierte Protokolltreiber rufen NdisDeregisterProtocol unter folgenden Umständen auf:

  • Der Treiber hat bereits NdisRegisterProtocol erfolgreich aufgerufen, kann jedoch 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 im Treiberobjekt eingerichtet wurde, wurde aufgerufen, oder die ProtocolUnbindAdapter--Funktion wurde aufgerufen, um die letzte verbleibende Bindung des Treibers freizugeben.

    Weitere Informationen zu den Unload-Routinen und anderen Standardmäßigen Kernelmodustreiberroutinen finden Sie unter Kernel-Mode Treiberkomponenten.

  • Das System wird heruntergefahren. Da der Treiber, der ein Protokoll der höchsten Ebene ist, IoRegisterShutdownNotification beim Initialisieren aufgerufen wurde, wurde die Shutdown-Routine aufgerufen.

    Weitere Informationen finden Sie unter IoRegisterShutdownNotification.

Wenn ein Protokoll offene Bindungen enthält, wird der Aufruf von NdisDeregisterProtocol bewirkt, dass NDIS die ProtocolUnbindAdapter- funktion des Protokolls einmal für jede offene Bindung aufruft. ProtocolUnbindAdapter ruft NdisCloseAdapter auf, um die Bindung zu schließen.

Wenn die Ausstehende geöffnet wurde, wurde NdisDeregisterProtocol alle Filter freigegeben, die der Aufrufer eingerichtet hat, und gibt den Speicher frei, der NDIS zugeordnet ist, um Bindungen und Filter für den Protokolltreiber nachzuverfolgen.

  • Zielplattform: universelle
  • Version: Für NDIS 6.0-Treiber in Windows Vista nicht unterstützt. Verwenden Sie stattdessen NdisDeregisterProtocolDriver-. Unterstützt für NDIS 5.1-Treiber in Windows Vista und Windows XP.

Anforderungen

Anforderung Wert
Header- ndis.h (include Ndis.h)
Library Ndis.lib
IRQL- PASSIVE_LEVEL

Siehe auch