Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Der NdisMRegisterUnloadHandler Funktion registriert einen Unload-Handler für einen Treiber.
Syntax
VOID NdisMRegisterUnloadHandler(
[in] NDIS_HANDLE NdisWrapperHandle,
[in] PDRIVER_UNLOAD UnloadHandler
);
Parameter
[in] NdisWrapperHandle
Gibt das von NdisMInitializeWrapperzurückgegebene Handle an.
[in] UnloadHandler
Gibt den Einstiegspunkt für die Unload-Routine des Treibers an. Eine Unload-Routine wird wie folgt deklariert:
VOID
(*PDRIVER_UNLOAD) (
IN struct _DRIVER_OBJECT *DriverObject
);
Rückgabewert
Nichts
Bemerkungen
Ein Treiber ruft NdisMRegisterUnloadHandler aus seiner DriverEntry--Funktion auf, nachdem DriverEntry-NdisMRegisterMiniport oder NdisIMRegisterLayeredMiniportaufgerufen hat. NdisMRegisterUnloadHandler registriert einen Unload-Handler für den Treiber.
Die Funktionalität des Unload-Handlers ist treiberspezifisch. Beispielsweise sollte ein Zwischentreiber einen Unload-Handler registrieren, der NdisDeregisterProtocol aufruft, um den Protokollteil des Zwischentreibers zu deregistern. Der Unload-Handler sollte auch alle erforderlichen Bereinigungsvorgänge ausführen, z. B. die Zuordnung von Ressourcen, die vom Protokollteil des Treibers verwendet werden.
Ein Miniporttreiber, z. B. ein Miniport-Miniporttreiber, der mehr als eine Miniporttreiberinstanz überwacht, sollte einen Unload-Handler registrieren, der Zustandsinformationen bereinigt und Ressourcen nach der Miniporttreiberinstanz, die überwacht wird, beendet wird. Beachten Sie, dass sich ein Unload-Handler von einer MiniportHalt-Funktion unterscheidet: Der Unload-Handler hat einen globaleren Bereich, während der Bereich der MiniportHalt-Funktion auf eine bestimmte Miniporttreiberinstanz beschränkt ist.
- Zielplattform: universelle
- Version: Für NDIS 6.0-Treiber in Windows Vista nicht unterstützt. Verwenden Sie stattdessen NdisMRegisterMiniportDriver-. 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 |