NdisFRegisterFilterDriver-Funktion (ndis.h)

Artikel
08/07/2023

Ein Filtertreiber ruft die NdisFRegisterFilterDriver-Funktion zum Registrieren der FilterXxx-Funktionen bei NDIS.

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 am Parameter Argument1 empfangen hat. (Weitere Informationen finden Sie unter DriverEntry of NDIS Filter Drivers.)

[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 den Einstiegspunkten der FilterXxx-Funktion erstellt und initialisiert hat.

[out] NdisFilterDriverHandle

Ein Zeiger auf eine Handle-Variable. Wenn der Aufruf von NdisFRegisterFilterDriver ist erfolgreich, NDIS füllt diese Variable mit einem Filtertreiberhandle. Der Filtertreiber speichert dieses Handle und übergibt dieses 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 status Werte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NdisFRegisterFilterDriver gibt NDIS_STATUS_SUCCESS zurück, wenn der Filtertreiber registriert wurde.
NDIS_STATUS_BAD_VERSION	Die Version, die im MajorNdisVersion-Member der Struktur unter FilterCharacteristics angegeben wird, ist ungültig.
NDIS_STATUS_BAD_CHARACTERISTICS	Mindestens eines der Elemente, die in angegeben sind NDIS_FILTER_DRIVER_CHARACTERISTICS ist ungültig.
NDIS_STATUS_INVALID_PARAMETER	Mindestens einer der Eingabeparameter, den der Treiber an übergeben hat NdisFRegisterFilterDriver ist ungültig.
NDIS_STATUS_RESOURCES	Fehler bei NdisFRegisterFilterDriver aufgrund unzureichender Ressourcen.
NDIS_STATUS_FAILURE	NdisFRegisterFilterDriver gibt NDIS_STATUS_FAILURE zurück, wenn keiner der vorherigen Werte zutrifft.

Hinweise

Ein Filtertreiber ruft die NdisFRegisterFilterDriver-Funktion aus der DriverEntry-Routine . Weitere Informationen zu DriverEntry finden Sie unter DriverEntry of NDIS Filter Drivers.

Treiber, die NdisFRegisterFilterDriver aufrufen, müssen auf einen sofortigen Aufruf einer ihrer FilterXxx-Funktionen vorbereitet sein. Weitere Informationen finden Sie unter Initialisieren eines Filtertreibers.

Jeder Filtertreiber exportiert einen Satz von FilterXxx-Funktionen , indem er die 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 auf. NdisFRegisterFilterDriver.

Nach der Registrierung kann ein Filtertreiber später die Funktion NdisSetOptionalHandlers aufrufen, um die Einstiegspunkte für optionale FilterXxx-Funktionen zu ändern.

Filtertreiber rufen die NdisFDeregisterFilterDriver-Funktion zum Freigeben von Ressourcen, die zuvor zugeordnet wurden NdisFRegisterFilterDriver.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Filter_Driver_Function(ndis), NdisFDeregisterFilterDriver(ndis)