FLT_PARAMETERS untuk serikat IRP_MJ_NETWORK_QUERY_OPEN

Artikel
02/24/2024

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

Sintaks

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIRP                           Irp;
    PFILE_NETWORK_OPEN_INFORMATION NetworkInformation;
  } NetworkQueryOpen;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Anggota

NetworkQueryOpen: Struktur yang berisi anggota berikut.
Irp: Penunjuk ke buat IRP yang mewakili operasi terbuka ini. IRP ini akan digunakan oleh sistem file untuk kode buka/buat umum tetapi tidak benar-benar selesai.
NetworkInformation: Penunjuk ke buffer terstruktur FILE_NETWORK_OPEN_INFORMATION untuk menerima informasi yang diminta tentang file.

Keterangan

Struktur FLT_PARAMETERS untuk operasi IRP_MJ_NETWORK_QUERY_OPEN berisi parameter untuk operasi NetworkQueryOpen yang diwakili oleh struktur (FLT_CALLBACK_DATA). Struktur FLT_PARAMETERS terkandung dalam struktur FLT_IO_PARAMETER_BLOCK.

Catatan

Objek file yang terkait dengan IRP_MJ_NETWORK_QUERY_OPEN adalah objek berbasis tumpukan. Filter yang terdaftar untuk panggilan balik NetworkQueryOpen tidak boleh mereferensikan objek ini. Artinya, jangan panggil ObReferenceObject atau ObDereferenceObject pada objek file berbasis tumpukan ini, dan jangan simpan penunjuk ke objek.

IRP_MJ_NETWORK_QUERY_OPEN adalah operasi I/O yang cepat. Ini setara dengan operasi FastIoQueryOpen (bukan FastIoQueryNetworkOpenInfo). Filter dapat menolak operasi dalam panggilan balik pra-operasinya menggunakan FLT_PREOP_DISALLOW_FASTIO. Ini tidak dapat menolak operasi dalam panggilan balik pasca-operasinya karena sistem file telah menyelesaikan operasi dan data ada.