Funzione NdisFRegisterFilterDriver (ndis.h)

Articolo
02/07/2025

Un driver di filtro chiama il funzione NdisFRegisterFilterDriver per registrare le funzioni FilterXxx con NDIS.

Sintassi

NDIS_STATUS NdisFRegisterFilterDriver(
  [in]  PDRIVER_OBJECT                      DriverObject,
  [in]  NDIS_HANDLE                         FilterDriverContext,
        PNDIS_FILTER_DRIVER_CHARACTERISTICS FilterDriverCharacteristics,
  [out] PNDIS_HANDLE                        NdisFilterDriverHandle
);

Parametri

[in] DriverObject

Puntatore a un oggetto driver opaco ricevuto dal driver di filtro nella routine DriverEntry nel parametro Argument1. Per altre informazioni, vedere DriverEntry dei driver di filtro NDIS.)

[in] FilterDriverContext

Handle per un'area di contesto allocata dal driver in cui il driver mantiene le informazioni sullo stato e sulla configurazione.

FilterDriverCharacteristics

Puntatore a un oggetto NDIS_FILTER_DRIVER_CHARACTERISTICS struttura creata e inizializzata dal driver di filtro con i relativi punti di ingresso della funzione filterXxx .

[out] NdisFilterDriverHandle

Puntatore a una variabile handle. Se la chiamata a NdisFRegisterFilterDriver ha esito positivo, NDIS riempie questa variabile con un handle del driver di filtro. Il driver di filtro salva questo handle e successivamente passa questo handle alle funzioni NDIS, ad esempio NdisFDeregisterFilterDriver, che richiedono un handle del driver di filtro come parametro di input.

Valore restituito

NdisFRegisterFilterDriver restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	NdisFRegisterFilterDriver restituisce NDIS_STATUS_SUCCESS se ha registrato il driver di filtro.
NDIS_STATUS_BAD_VERSION	La versione specificata nel membro MajorNdisVersion della struttura in FilterCharacteristics non è valida.
NDIS_STATUS_BAD_CHARACTERISTICS	Almeno uno dei membri specificati in NDIS_FILTER_DRIVER_CHARACTERISTICS non è valido.
NDIS_STATUS_INVALID_PARAMETER	Almeno uno dei parametri di input passati dal driver NdisFRegisterFilterDriver non è valido.
NDIS_STATUS_RESOURCES	NdisFRegisterFilterDriver non riuscito a causa di risorse insufficienti.
NDIS_STATUS_FAILURE	NdisFRegisterFilterDriver restituisce NDIS_STATUS_FAILURE se non si applica nessuno dei valori precedenti.

Osservazioni

Un driver di filtro chiama il funzione NdisFRegisterFilterDriver dalla routine DriverEntry. Per altre informazioni su DriverEntry, vedere DriverEntry dei driver di filtro NDIS.

I driver che chiamano NdisFRegisterFilterDriver devono essere preparati per una chiamata immediata a una delle relative funzioni di FilterXxx. Per altre informazioni, vedere inizializzazione di un driver di filtro.

Ogni driver di filtro esporta un set di funzioni filterXxx configurando NDIS_FILTER_DRIVER_CHARACTERISTICS struttura e chiamata NdisFRegisterFilterDriver. NDIS copia questa struttura nella risorsa di archiviazione interna della libreria NDIS.

Per consentire ai driver di filtro di registrare i servizi facoltativi, NDIS chiama la funzione FilterSetOptions nel contesto di NdisFRegisterFilterDriver.

Dopo la registrazione, un driver di filtro può in seguito chiamare la funzione NdisSetOptionalHandlers per modificare i punti di ingresso per le funzioni facoltative FilterXxx.

I driver di filtro chiamano il funzione NdisFDeregisterFilterDriver per rilasciare le risorse allocate in precedenza con NdisFRegisterFilterDriver.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
piattaforma di destinazione	Desktop
intestazione	ndis.h (include Ndis.h)
libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
regole di conformità DDI	Irql_Filter_Driver_Function(ndis), NdisFDeregisterFilterDriver(ndis)