FLT_PARAMETERS untuk serikat IRP_MJ_QUERY_OPEN

Artikel
02/24/2024

Komponen serikat berikut digunakan ketika bidang MajorFunction dari struktur FLT_IO_PARAMETER_BLOCK untuk operasi IRP_MJ_QUERY_OPEN.

Sintaks

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIRP                   Irp;
    PVOID                  FileInformation;
    PULONG                 Length;
    FILE_INFORMATION_CLASS FileInformationClass;
  } QueryOpen;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Anggota

Irp: Penunjuk ke IRP yang terkait dengan operasi ini.
FileInformation: Penunjuk ke buffer yang dialokasikan pemanggil tempat rutin menulis informasi yang diminta tentang objek file. Anggota FileInformationClass menentukan jenis informasi yang diminta pemanggil.
Panjang: Penunjuk ke ukuran, dalam byte, dari buffer yang diacu oleh FileInformation.

FileInformationClass: Menentukan jenis informasi yang akan dikembalikan tentang file, dalam buffer yang dituju fileInformation . Perangkat dan driver perantara dapat menentukan salah satu nilai FILE_INFORMATION_CLASS berikut. Nilai lain menyebabkan panggilan gagal dan tidak boleh diteruskan ke panggilan PreQueryOpen/PostQueryOpen.

nilai FILE_INFORMATION_CLASS	Jenis informasi yang dikembalikan
FileStatInformation	Struktur FILE_STAT_INFORMATION . Struktur ini berisi masker akses. Untuk informasi selengkapnya tentang masker akses, lihat ACCESS_MASK.
FileStatLxInformation	Struktur FILE_STAT_LX_INFORMATION . Struktur ini berisi masker akses. Untuk informasi selengkapnya tentang masker akses, lihat ACCESS_MASK.
FileCaseSensitiveInformation	Struktur FILE_CASE_SENSITIVE_INFORMATION .
FileStatBasicInformation	Struktur FILE_STAT_BASIC_INFORMATION .

Keterangan

Struktur FLT_PARAMETERS untuk operasi IRP_MJ_QUERY_OPEN berisi parameter untuk operasi QueryOpen yang diwakili oleh struktur data panggilan balik (FLT_CALLBACK_DATA). Ini terkandung dalam struktur FLT_IO_PARAMETER_BLOCK.

IRP_MJ_QUERY_OPEN adalah operasi panggilan balik sistem file (FSFilter). Filter dapat menolak operasi dalam panggilan balik pra-operasi dan panggilan balik pasca-operasinya menggunakan FLT_PREOP_DISALLOW_FSFILTER_IO dan FLT_POSTOP_DISALLOW_FSFILTER_IO.

Sistem File tidak mengisi bidang Informasi di blok IO_STATUS. Filter tidak boleh memeriksa nilai ini dalam pasca-panggilannya.

Untuk informasi selengkapnya tentang operasi panggilan balik FSFilter, lihat entri referensi untuk FsRtlRegisterFileSystemFilterCallbacks.