Funzione FilterVolumeInstanceFindNext (fltuser.h)

Articolo
02/29/2024

La funzione FilterVolumeInstanceFindNext continua un'istanza del driver minifilter o una ricerca del driver di filtro legacy avviata da una chiamata a FilterVolumeInstanceFindFirst.

Sintassi

HRESULT FilterVolumeInstanceFindNext(
  [in]  HANDLE                     hVolumeInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Parametri

[in] hVolumeInstanceFind

Handle di ricerca del driver di filtro dei volumi restituito da una chiamata precedente a FilterVolumeInstanceFindFirst.

[in] dwInformationClass

Tipo di struttura delle informazioni del driver di filtro restituito. Questo parametro deve contenere uno dei valori seguenti.

Valore	Significato
InstanceBasicInformation	Restituisce una struttura INSTANCE_BASIC_INFORMATION per un'istanza di minifilter. I driver di filtro legacy vengono ignorati.
InstanceFullInformation	Restituisce una struttura INSTANCE_FULL_INFORMATION per un'istanza di minifilter. I driver di filtro legacy vengono ignorati.
InstancePartialInformation	Restituisce una struttura INSTANCE_PARTIAL_INFORMATION per un'istanza di minifilter. I driver di filtro legacy vengono ignorati.
InstanceAggregateStandardInformation	Restituisce una struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION per l'istanza di . Il membro LegacyFilter della struttura non viene utilizzato. Questa struttura è disponibile a partire da Windows Vista.

[out] lpBuffer

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

[in] dwBufferSize

Dimensioni, in byte, del buffer a cui punta il parametro lpBuffer . Il chiamante deve impostare questo parametro in base all'oggetto dwInformationClass specificato.

[out] lpBytesReturned

Puntatore a una variabile allocata dal chiamante che riceve il numero di byte restituiti nel buffer a cui lpBuffer punta se la chiamata a FilterVolumeInstanceFindNext ha esito positivo. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FilterVolumeInstanceFindNext restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un valore di errore HRESULT, ad esempio uno dei seguenti:

Codice restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il buffer a cui punta lpBuffer non è sufficiente per contenere le informazioni richieste. Quando viene restituito questo valore, lpBytesReturned conterrà le dimensioni, in byte, del buffer necessario per la struttura dwInformationClass specificata.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	È stato specificato un valore non valido per il parametro dwInformationClass . Ad esempio, se InstanceAggregateStandardInformation viene specificato per un sistema operativo precedente a Windows Vista, FilterVolumeInstanceFindNext restituisce questo valore HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Non sono stati trovati altri driver di filtro nel volume specificato.

Commenti

FilterVolumeInstanceFindNext trova un driver di filtro per ogni chiamata.

Dopo aver stabilito l'handle di ricerca chiamando FilterVolumeInstanceFindFirst, usare la funzione FilterVolumeInstanceFindNext per cercare altri driver di filtro collegati al volume specificato nella chiamata a FilterVolumeInstanceFindFirst. Quando l'handle di ricerca non è più necessario, chiuderlo chiamando FilterVolumeInstanceFindClose.

A partire da Windows Vista, questa routine può restituire sia informazioni sul driver di filtro legacy che informazioni sull'istanza del driver minifilter quando il valore del parametro dwInformationClass è InstanceAggregateStandardInformation. Per i sistemi operativi precedenti, questa routine non può restituire informazioni sul filtro legacy perché la struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION non è disponibile.