Fungsi FltRequestFileInfoOnCreateCompletion (fltkernel.h)

  • Artikel

Minifilter memanggil FltRequestFileInfoOnCreateCompletion selama pra-buat file untuk meminta agar manajer file menyimpan informasi file untuk diambil selama pembuatan postingan.

Sintaks

NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
  PFLT_FILTER        Filter,
  PFLT_CALLBACK_DATA Data,
  ULONG              InfoClassFlags
);

Parameter

Filter

Penunjuk filter buram yang secara unik mengidentifikasi driver minifilter.

Data

Arahkan ke data panggilan balik FLT_CALLBACK_DATA yang mewakili operasi pembuatan I/O.

InfoClassFlags

Bendera bitmask yang menunjukkan jenis informasi file yang harus disimpan sistem file untuk diambil selama pembuatan pos. Dapat berupa kombinasi dari bendera berikut:

Bendera Makna
QoCFileStatInformation (0x00000001) Jika diatur, sistem file akan menyimpan informasi statistik file dalam struktur QUERY_ON_CREATE_FILE_STAT_INFORMATION untuk pengambilan.
QoCFileLxInformation (0x00000002) Jika diatur, sistem file akan menyimpan informasi seperti Linux yang diperluas dalam struktur QUERY_ON_CREATE_FILE_LX_INFORMATION untuk pengambilan.
QoCFileEaInformation (0x00000004) Jika diatur, sistem file akan menyimpan atribut yang diperluas (EA) dalam struktur QUERY_ON_CREATE_EA_INFORMATION untuk pengambilan.

Nilai kembali

FltRequestFileInfoOnCreateCompletion dapat mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Sistem file berhasil menyimpan informasi file yang diminta.
STATUS_INSUFFICIENT_RESOURCES FltRequestFileInfoOnCreateCompletion tidak dapat mengalokasikan memori yang cukup untuk menyimpan informasi file yang diminta.
STATUS_INVALID_PARAMETER_2 Objek data panggilan balik yang disediakan bukan operasi pembuatan berbasis IRP.

Keterangan

Minifilter dapat mengambil informasi file dengan memanggil FltRetrieveFileInfoOnCreateCompletionEx atau FltRetrieveFileInfoOnCreateCompletion selama pembuatan posting. Performa minifilter biasanya lebih baik ketika meminta dan mengambil informasi file dengan cara ini, daripada mengkueri informasi file di lain waktu.

Persyaratan

Persyaratan Nilai
Header fltkernel.h (termasuk Fltkernel.h)

Lihat juga

FLT_CALLBACK_DATA

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx