NdisMDeregisterDevice-Funktion (ndis.h)

  • Artikel

Hinweis NDIS 5. x wurde veraltet und wird von NDIS 6 abgelöst. x. Informationen zur Entwicklung neuer NDIS-Treiber finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x-Treiber auf NDIS 6. x, siehe Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

Die NdisMDeregisterDevice-Funktion entfernt ein Geräteobjekt aus dem System, das mit NdisMRegisterDevice erstellt wurde. NdisMDeregisterDevice entfernt auch den symbolischen Link, der diesem Geräteobjekt zugeordnet ist.

Syntax

NDIS_STATUS NdisMDeregisterDevice(
  [in] NDIS_HANDLE NdisDeviceHandle
);

Parameter

[in] NdisDeviceHandle

Gibt das von NdisMRegisterDevice zurückgegebene Handle an, das das Zu registrierende Geräteobjekt identifiziert.

Rückgabewert

NdisMDeregisterDevice gibt NDIS_STATUS_SUCCESS zurück, wenn das Geräteobjekt und das zugehörige symbolische Linkobjekt gelöscht werden.

Hinweise

Ein Treiber ruft NdisMDeregisterDevice über seine Halt - oder Unload-Funktion auf, um die Registrierung eines eigenständigen Geräteobjekts aufzuheben, das er zuvor mit NdisMRegisterDevice erstellt hat. Der Treiber muss NdisMDeregisterDevice aufrufen, wenn er entladen wird oder wenn seine DriverEntry-Routine auf einen schwerwiegenden Initialisierungsfehler stößt, z. B. eine Unfähigkeit, Systemressourcen abzurufen.

Wenn NdisMRegisterDevice aufgerufen wird, kann es keine ausstehenden Benutzermodus-Öffnungsvorgänge für das zu löschende Geräteobjekt geben. Falls vorhanden, tritt ein Systemfehler auf.

  • Zielplattform: Universell
  • Version: Wird für NDIS 6.0-Treiber in Windows Vista nicht unterstützt. Unterstützt für NDIS 5.1-Treiber in Windows Vista und Windows XP.

Anforderungen

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

Weitere Informationen