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.
Ein Filtertreiber ruft die NdisFRegisterFilterDriver--Funktion, um die FilterXxx--Funktionen mit NDIS zu registrieren.
Syntax
NDIS_STATUS NdisFRegisterFilterDriver(
[in] PDRIVER_OBJECT DriverObject,
[in] NDIS_HANDLE FilterDriverContext,
PNDIS_FILTER_DRIVER_CHARACTERISTICS FilterDriverCharacteristics,
[out] PNDIS_HANDLE NdisFilterDriverHandle
);
Parameter
[in] DriverObject
Ein Zeiger auf ein undurchsichtiges Treiberobjekt, das der Filtertreiber in seiner DriverEntry Routine im Argument1 Parameter erhalten hat. (Weitere Informationen finden Sie unter DriverEntry von NDIS-Filtertreibern.)
[in] FilterDriverContext
Ein Handle für einen vom Treiber zugewiesenen Kontextbereich, in dem der Treiber Zustands- und Konfigurationsinformationen verwaltet.
FilterDriverCharacteristics
Ein Zeiger auf einen NDIS_FILTER_DRIVER_CHARACTERISTICS Struktur, die der Filtertreiber mit seinen FilterXxx Funktionseinstiegspunkten erstellt und initialisiert hat.
[out] NdisFilterDriverHandle
Ein Zeiger auf eine Handlevariable. Wenn der Anruf an NdisFRegisterFilterDriver erfolgreich ist, füllt NDIS diese Variable mit einem Filtertreiberhandle aus. Der Filtertreiber speichert dieses Handle und übergibt diesen Handle später an NDIS-Funktionen, z. B. NdisFDeregisterFilterDriver, für die ein Filtertreiberhandle als Eingabeparameter erforderlich ist.
Rückgabewert
NdisFRegisterFilterDriver gibt einen der folgenden Statuswerte zurück:| Rückgabecode | Beschreibung |
|---|---|
|
NdisFRegisterFilterDriver gibt NDIS_STATUS_SUCCESS zurück, wenn er den Filtertreiber registriert hat. |
|
Die im MajorNdisVersion Element der Struktur bei FilterCharacteristics angegebene Version ist ungültig. |
|
Mindestens eines der Elemente, die in NDIS_FILTER_DRIVER_CHARACTERISTICS ist ungültig. |
|
Mindestens einer der Eingabeparameter, an die der Treiber übergeben wurde NdisFRegisterFilterDriver- ungültig ist. |
|
NdisFRegisterFilterDriver aufgrund unzureichender Ressourcen fehlgeschlagen. |
|
NdisFRegisterFilterDriver gibt NDIS_STATUS_FAILURE zurück, wenn keines der vorherigen Werte zutrifft. |
Bemerkungen
Ein Filtertreiber ruft die NdisFRegisterFilterDriver Funktion aus der DriverEntry- Routine aus. Weitere Informationen zu DriverEntry-finden Sie unter DriverEntry von NDIS-Filtertreibern.
Treiber, die NdisFRegisterFilterDriver- aufrufen, müssen für einen sofortigen Aufruf einer ihrer FilterXxx--Funktionen vorbereitet sein. Weitere Informationen finden Sie unter Initialisieren eines Filtertreibers.
Jeder Filtertreiber exportiert eine Reihe von FilterXxx- Funktionen durch Einrichten der NDIS_FILTER_DRIVER_CHARACTERISTICS Struktur und Aufrufen NdisFRegisterFilterDriver. NDIS kopiert diese Struktur in den internen Speicher der NDIS-Bibliothek.
Damit Filtertreiber optionale Dienste registrieren können, ruft NDIS die FilterSetOptions--Funktion im Kontext von NdisFRegisterFilterDriver.
Nachdem er registriert wurde, kann ein Filtertreiber später die NdisSetOptionalHandlers--Funktion aufrufen, um die Einstiegspunkte für optionale FilterXxx--Funktionen zu ändern.
Filtertreiber rufen die NdisFDeregisterFilterDriver--Funktion zum Freigeben von Ressourcen, die zuvor zugeordnet waren NdisFRegisterFilterDriver.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Filter_Driver_Function(ndis), NdisFDeregisterFilterDriver(ndis) |
Siehe auch
DriverEntry von NDIS-Filtertreibern
Initialisieren eines Filtertreibers
NDIS_FILTER_DRIVER_CHARACTERISTICS