Funzione FltGetFilterInformation (fltkernel.h)

Articolo
08/07/2023

La routine FltGetFilterInformation fornisce informazioni su un driver minifilter.

Sintassi

NTSTATUS FLTAPI FltGetFilterInformation(
  [in]  PFLT_FILTER              Filter,
  [in]  FILTER_INFORMATION_CLASS InformationClass,
  [out] PVOID                    Buffer,
  [in]  ULONG                    BufferSize,
  [out] PULONG                   BytesReturned
);

Parametri

[in] Filter

Puntatore di filtro opaco per il chiamante.

[in] InformationClass

Tipo di informazioni richieste. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
FilterFullInformation	Il buffer a cui punta il parametro Buffer riceve una struttura FILTER_FULL_INFORMATION per il driver minifilter.
FilterAggregateBasicInformation	Il buffer a cui punta il parametro Buffer riceve una struttura FILTER_AGGREGATE_BASIC_INFORMATION per il driver minifilter. Questo valore InformationClass è disponibile a partire da Microsoft Windows Server 2003 SP1 e Windows XP SP2 con rollup di Gestione filtri. Per altre informazioni sul pacchetto cumulativo di Gestione filtri per Windows XP SP2, vedere l'articolo 914882, " Pacchetto cumulativo di Gestione filtri per Windows XP SP2", nella Microsoft Knowledge Base.
FilterAggregateStandardInformation	Il buffer a cui punta il parametro Buffer riceve una struttura FILTER_AGGREGATE_STANDARD_INFORMATION per il driver minifilter. La parte LegacyFilter della struttura non viene utilizzata. Questo valore InformationClass è disponibile a partire da Windows Vista.

[out] Buffer

Puntatore a un buffer allocato dal chiamante che riceve le informazioni richieste. Il tipo delle informazioni restituite nel buffer è definito dal parametro InformationClass .

[in] BufferSize

Dimensioni, in byte, del buffer a cui punta il parametro Buffer . Il chiamante deve impostare questo parametro in base al valore InformationClass specificato.

[out] BytesReturned

Puntatore a una variabile allocata dal chiamante che riceve il numero di byte restituiti nel buffer a cui punta Buffer . Se il valore di input di BufferSize è troppo piccolo, FltGetFilterInformation restituisce STATUS_BUFFER_TOO_SMALL e imposta questa variabile sul numero di byte necessari per archiviare le informazioni richieste. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FltGetFilterInformation restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_BUFFER_TOO_SMALL	Buffer a cui punta il parametro Buffer non è sufficiente per archiviare le informazioni richieste. Si tratta di un codice di errore.
STATUS_INVALID_PARAMETER	È stato specificato un valore non valido per il parametro InformationClass . Ad esempio, se FilterAggregateStandardInformation viene specificato in un sistema operativo prima di Windows Vista, la routine restituisce STATUS_INVALID_PARAMETER. Si tratta di un codice di errore.