FLT_PARAMETERS sjednocení IRP_MJ_NETWORK_QUERY_OPEN

Článek
2025-04-10

Následující sjednocovacího komponenty se používá, pokud je pole MajorFunction struktury FLT_IO_PARAMETER_BLOCK operace IRP_MJ_NETWORK_QUERY_OPEN.

Syntaxe

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

Členové

NetworkQueryOpen: Struktura obsahující následující členy.
Irp: Ukazatel na vytvoření protokolu IRP, který představuje tuto otevřenou operaci. Tento protokol IRP je používán systémem souborů pro běžný kód open/create, ale ve skutečnosti se nedokončil.
NetworkInformation: Ukazatel na FILE_NETWORK_OPEN_INFORMATION strukturovanou vyrovnávací paměť pro příjem požadovaných informací o souboru.

Poznámky

Struktura FLT_PARAMETERS operací IRP_MJ_NETWORK_QUERY_OPEN obsahuje parametry pro operaci NetworkQueryOpen reprezentovanou strukturou (FLT_CALLBACK_DATA). Struktura FLT_PARAMETERS je obsažena ve struktuře FLT_IO_PARAMETER_BLOCK .

Poznámka:

Objekt souboru přidružený k IRP_MJ_NETWORK_QUERY_OPEN je objekt založený na zásobníku. Filtr zaregistrovaný pro zpětné volání NetworkQueryOpen nesmí odkazovat na tento objekt. To znamená, nevolejte ObReferenceObject nebo ObDereferenceObject na tomto objektu souboru založeného na zásobníku a neuložte ukazatel na objekt.

IRP_MJ_NETWORK_QUERY_OPEN je rychlá vstupně-výstupní operace. Je to ekvivalent operace FastIoQueryOpen (nikoli FastIoQueryNetworkOpenInfo). Filtr může operaci odmítnout v jejím zpětném volání před operací pomocí FLT_PREOP_DISALLOW_FASTIO. Operaci v zpětném volání po operaci nemůže odmítnout, protože systém souborů už operaci dokončil a data jsou k dispozici.