Funzione FltGetInstanceInformation (fltkernel.h)

Articolo
08/07/2023

La routine FltGetInstanceInformation restituisce informazioni su un'istanza del driver minifilter.

Sintassi

NTSTATUS FLTAPI FltGetInstanceInformation(
  [in]  PFLT_INSTANCE              Instance,
  [in]  INSTANCE_INFORMATION_CLASS InformationClass,
  [out] PVOID                      Buffer,
  [in]  ULONG                      BufferSize,
  [out] PULONG                     BytesReturned
);

Parametri

[in] Instance

Puntatore istanza opaca per il chiamante.

[in] InformationClass

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

Valore	Significato
InstanceBasicInformation	Il buffer a cui punta il parametro Buffer riceve una struttura INSTANCE_BASIC_INFORMATION per l'istanza.
InstanceFullInformation	Il buffer a cui punta il parametro Buffer riceve una struttura INSTANCE_FULL_INFORMATION per l'istanza.
InstancePartialInformation	Il buffer a cui punta il parametro Buffer riceve una struttura INSTANCE_PARTIAL_INFORMATION per l'istanza.
InstanceAggregateStandardInformation	Il buffer a cui punta il parametro Buffer riceve una struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION per l'istanza. La parte LegacyFilter della struttura non viene utilizzata. Questa struttura è 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, FltGetInstanceInformation 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

FltGetInstanceInformation 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 InstanceAggregateStandardInformation viene specificato nei sistemi operativi precedenti a Windows Vista, la routine restituirà STATUS_INVALID_PARAMETER. Si tratta di un codice di errore.

Commenti

Dato un puntatore a un'istanza di minifilter, questa routine restituisce informazioni sull'istanza del minifilter. Il tipo di informazioni sull'istanza restituite è determinato dal parametro InformationClass .