Fungsi FilterGetInformation (fltuser.h)

Artikel
08/23/2023

Fungsi FilterGetInformation mengembalikan berbagai jenis informasi tentang minifilter.

Sintaks

HRESULT FilterGetInformation(
  [in]  HFILTER                  hFilter,
  [in]  FILTER_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                   lpBuffer,
  [in]  DWORD                    dwBufferSize,
  [out] LPDWORD                  lpBytesReturned
);

Parameter

[in] hFilter

Menangani yang dikembalikan oleh panggilan sebelumnya ke fungsi FilterCreate .

[in] dwInformationClass

Jenis informasi yang diminta. Parameter ini harus menjadi salah satu nilai berikut.

Nilai	Makna
FilterFullInformation	Mengembalikan struktur FILTER_FULL_INFORMATION untuk minifilter.
FilterAggregateBasicInformation	Mengembalikan struktur FILTER_AGGREGATE_BASIC_INFORMATION untuk minifilter. Nilai dwInformationClass ini tersedia dimulai dengan Microsoft Windows Server 2003 dengan SP1 dan Microsoft Windows XP dengan SP2 dengan rollup manajer filter. Untuk informasi selengkapnya tentang paket rollup manajer filter untuk Windows XP dengan SP2, lihat artikel 914882, " Paket rollup manajer filter untuk Windows XP SP2," di Pangkalan Pengetahuan Microsoft.
FilterAggregateStandardInformation	Mengembalikan struktur FILTER_AGGREGATE_STANDARD_INFORMATION untuk setiap minifilter. Bagian LegacyFilter dari struktur tidak digunakan. Nilai dwInformationClass ini tersedia dimulai dengan Windows Vista.

[out] lpBuffer

Arahkan ke buffer yang dialokasikan penelepon yang menerima informasi yang diminta. Jenis informasi yang dikembalikan dalam buffer ditentukan oleh parameter dwInformationClass .

[in] dwBufferSize

Ukuran, dalam byte, dari buffer yang dirujuk parameter lpBuffer . Pemanggil harus mengatur parameter ini sesuai dengan dwInformationClass yang diberikan.

[out] lpBytesReturned

Penunjuk ke variabel yang dialokasikan penelepon yang menerima jumlah byte yang dikembalikan dalam buffer yang dituju lpBuffer jika panggilan ke FilterGetInformation berhasil. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FilterGetInformation mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan HRESULT, seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Buffer yang diacu oleh lpBuffer tidak cukup besar untuk berisi informasi yang diminta. Ketika nilai ini dikembalikan, lpBytesReturned akan berisi ukuran, dalam byte, dari buffer yang diperlukan untuk struktur dwInformationClass yang diberikan.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Nilai yang tidak valid ditentukan untuk parameter dwInformationClass . Misalnya, jika FilterAggregateStandardInformation ditentukan untuk sistem operasi sebelum Windows Vista, FilterGetInformation mengembalikan nilai HRESULT ini.