FLT_PARAMETERS untuk serikat IRP_MJ_QUERY_EA

Artikel
02/07/2024

Komponen union yang digunakan ketika bidang MajorFunction dari struktur FLT_IO_PARAMETER_BLOCK untuk operasi IRP_MJ_QUERY_EA.

Sintaks

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    ULONG                    Length;
    PVOID                    EaList;
    ULONG                    EaListLength;
    ULONG  POINTER_ALIGNMENT EaIndex;
    PVOID                    EaBuffer;
    PMDL                     MdlAddress;
  } QueryEa;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Anggota

QueryEa: Struktur dalam FLT_PARAMETERS gabungan yang berisi anggota berikut.
Panjang: Panjang, dalam byte, dari buffer yang menunjuk EaBuffer .
EaList: Penunjuk ke buffer input yang disediakan penelepon, FILE_GET_EA_INFORMATION terstruktur yang menentukan atribut yang diperluas untuk dikueri.
EaListLength: Panjang, dalam byte, dari buffer yang dirujuk EaList .
EaIndex: Indeks entri untuk mulai memindai daftar atribut yang diperluas. Parameter ini diabaikan jika bendera SL_INDEX_SPECIFIED tidak diatur dalam struktur FLT_IO_PARAMETER_BLOCK untuk operasi atau jika EaList menunjuk ke daftar yang tidak ada.
EaBuffer: Penunjuk ke buffer output yang disediakan pemanggil, FILE_FULL_EA_INFORMATION di mana nilai atribut yang diperluas akan dikembalikan. Anggota ini bersifat opsional dan dapat berupa NULL jika MDL disediakan di MdlAddress. Lihat Keterangan.
MdlAddress: Alamat daftar deskriptor memori (MDL) yang menjelaskan buffer yang ditunjuk EaBuffer . Anggota ini bersifat opsional dan dapat berupa NULL jika buffer disediakan di EaBuffer. Lihat Keterangan.

Keterangan

Struktur FLT_PARAMETERS untuk operasi IRP_MJ_QUERY_EA berisi parameter untuk operasi informasi atribut yang diperluas kueri berbasis IRP yang diwakili oleh struktur data panggilan balik (FLT_CALLBACK_DATA). Ini terkandung dalam struktur FLT_IO_PARAMETER_BLOCK.

Jika buffer EaBuffer dan MdlAddress disediakan, disarankan agar minifilter menggunakan MDL. Memori yang dituju EaBuffer valid ketika merupakan alamat mode pengguna yang diakses dalam konteks proses panggilan, atau jika itu adalah alamat mode kernel.

Jika minifilter mengubah nilai MdlAddress, maka setelah panggilan balik operasi pasca operasinya, Filter Manager akan membebaskan MDL yang saat ini disimpan di MdlAddress dan memulihkan nilai MdlAddress sebelumnya.

IRP_MJ_QUERY_EA adalah operasi berbasis IRP.