Fungsi FilterGetInformation (fltuser.h)
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 |
---|---|
|
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. |
|
Nilai yang tidak valid ditentukan untuk parameter dwInformationClass . Misalnya, jika FilterAggregateStandardInformation ditentukan untuk sistem operasi sebelum Windows Vista, FilterGetInformation mengembalikan nilai HRESULT ini. |
Keterangan
FilterGetInformation setara dengan Win32 FltGetFilterInformation.
Persyaratan
Target Platform | Universal |
Header | fltuser.h (termasuk FltUser.h) |
Pustaka | FltLib.lib |
DLL | FltLib.dll |
Lihat juga
FILTER_AGGREGATE_BASIC_INFORMATION
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk