Fungsi FltGetInstanceInformation (fltkernel.h)

Artikel
03/05/2024

Rutinitas FltGetInstanceInformation mengembalikan informasi tentang instans driver minifilter.

Sintaks

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

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil.

[in] InformationClass

Jenis informasi yang diminta. Parameter ini dapat memiliki salah satu nilai berikut.

Nilai	Makna
InstanceBasicInformation	Buffer yang ditunjukkan oleh parameter Buffer menerima struktur INSTANCE_BASIC_INFORMATION untuk instans.
InstanceFullInformation	Buffer yang ditujukkan oleh parameter Buffer menerima struktur INSTANCE_FULL_INFORMATION untuk instans.
InstancePartialInformation	Buffer yang ditujukkan oleh parameter Buffer menerima struktur INSTANCE_PARTIAL_INFORMATION untuk instans.
InstanceAggregateStandardInformation	Buffer yang ditujukkan oleh parameter Buffer menerima struktur INSTANCE_AGGREGATE_STANDARD_INFORMATION untuk instans. Bagian LegacyFilter dari struktur tidak digunakan. Struktur ini tersedia dimulai dengan Windows Vista.

[out] Buffer

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

[in] BufferSize

Ukuran, dalam byte, dari buffer yang dirujuk oleh parameter Buffer . Pemanggil harus mengatur parameter ini sesuai dengan nilai InformationClass yang diberikan.

[out] BytesReturned

Penunjuk ke variabel yang dialokasikan penelepon yang menerima jumlah byte yang dikembalikan dalam buffer yang dituju Buffer . Jika nilai input BufferSize terlalu kecil, FltGetInstanceInformation mengembalikan STATUS_BUFFER_TOO_SMALL dan mengatur variabel ini ke jumlah byte yang diperlukan untuk menyimpan informasi yang diminta. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FltGetInstanceInformation mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti salah satu dari berikut ini:

Menampilkan kode	Deskripsi
STATUS_BUFFER_TOO_SMALL	Buffer yang dituju parameter Buffer tidak cukup besar untuk menyimpan informasi yang diminta. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Nilai yang tidak valid ditentukan untuk parameter InformationClass . Misalnya, jika InstanceAggregateStandardInformation ditentukan pada sistem operasi sebelum Windows Vista, rutinitas akan mengembalikan STATUS_INVALID_PARAMETER. Ini adalah kode kesalahan.

Keterangan

Mengingat penunjuk ke instans minifilter, rutinitas ini mengembalikan informasi tentang instans minifilter. Jenis informasi instans yang dikembalikan ditentukan oleh parameter InformationClass .