Freigeben über

NdisMRegisterUnloadHandler-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 NdisMRegisterUnloadHandler-Funktion registriert einen Entladehandler für einen Treiber.

Syntax

void NdisMRegisterUnloadHandler(
  [in] NDIS_HANDLE    NdisWrapperHandle,
  [in] PDRIVER_UNLOAD UnloadHandler
);

Parameter

[in] NdisWrapperHandle

Gibt das von NdisMInitializeWrapper zurückgegebene Handle an.

[in] UnloadHandler

Gibt den Einstiegspunkt für die Entladeroutine des Treibers an. Eine Entladeroutine wird wie folgt deklariert:

VOID
(*PDRIVER_UNLOAD) (
    IN struct _DRIVER_OBJECT *DriverObject
    );

Rückgabewert

Keine

Bemerkungen

Ein Treiber ruft NdisMRegisterUnloadHandler über seine DriverEntry-Funktion auf, nachdem DriverEntryNdisMRegisterMiniport oder NdisIMRegisterLayeredMiniport aufgerufen hat. NdisMRegisterUnloadHandler registriert einen Entladehandler für den Treiber.

Die Funktionalität des Entladehandlers ist treiberspezifisch. Beispielsweise sollte ein Zwischentreiber einen Entladehandler registrieren, der NdisDeregisterProtocol aufruft, um die Registrierung des Protokollteils des Zwischentreibers aufzuheben. Der Entladehandler sollte auch alle erforderlichen Bereinigungsvorgänge ausführen, z. B. das Aufheben der Zuordnung von Ressourcen, die vom Protokollteil des Treibers verwendet werden.

Ein Miniporttreiber, z. B. ein Lastenausgleichs-Miniporttreiber, der mehrere Miniporttreiber überwacht, instance sollte einen Entladehandler registrieren, der Zustandsinformationen bereinigt und die Zuordnung von Ressourcen aufgehoben, nachdem die überwachten Miniporttreiberinstanzen angehalten wurden. Beachten Sie, dass sich ein Entladehandler von einer MiniportHalt-Funktion unterscheidet: Der Entladehandler verfügt über einen globaleren Bereich, während der Bereich der MiniportHalt-Funktion auf einen bestimmten Miniporttreiber instance beschränkt ist.

Anforderungen

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

Weitere Informationen