FLT_PARAMETERS für IRP_MJ_QUERY_OPEN Union

2025-04-10

Die folgende Union-Komponente wird verwendet, wenn das Feld "MajorFunction " der FLT_IO_PARAMETER_BLOCK Struktur für den Vorgang IRP_MJ_QUERY_OPEN ist.

Syntax

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

Elemente

Irp: Ein Zeiger auf das diesem Vorgang zugeordnete IRP.
FileInformation: Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in den die Routine die angeforderten Informationen zum Dateiobjekt schreibt. Der FileInformationClass Member gibt den Typ der Informationen an, die der Aufrufer anfordert.
Länge: Ein Zeiger auf die Größe des Puffers in Bytes, auf den fileInformation verweist.

FileInformationClass: Gibt den Typ der Informationen an, auf die die Datei zurückgegeben werden soll, im Puffer, auf den FileInformation verweist. Geräte- und Zwischentreiber können einen der folgenden FILE_INFORMATION_CLASS Werte angeben. Andere Werte führen dazu, dass der Aufruf fehlschlägt und nicht an PreQueryOpen/PostQueryOpen-Aufrufe übergeben werden sollte.

wert FILE_INFORMATION_CLASS	Zurückgegebener Informationstyp
FileStatInformation	Eine FILE_STAT_INFORMATION Struktur. Diese Struktur enthält eine Zugriffsmaske. Weitere Informationen zu Zugriffsmasken finden Sie unter ACCESS_MASK.
FileStatLxInformation	Eine FILE_STAT_LX_INFORMATION Struktur. Diese Struktur enthält eine Zugriffsmaske. Weitere Informationen zu Zugriffsmasken finden Sie unter ACCESS_MASK.
FileCaseSensitiveInformation	Eine FILE_CASE_SENSITIVE_INFORMATION Struktur.
FileStatBasicInformation	Eine FILE_STAT_BASIC_INFORMATION Struktur.

Bemerkungen

Die FLT_PARAMETERS Struktur für IRP_MJ_QUERY_OPEN-Vorgänge enthält die Parameter für einen QueryOpen-Vorgang , der durch eine Rückrufdatenstruktur (FLT_CALLBACK_DATA) dargestellt wird. Sie ist in einer FLT_IO_PARAMETER_BLOCK Struktur enthalten.

IRP_MJ_QUERY_OPEN ist ein Dateisystem(FSFilter)-Rückrufvorgang. Ein Filter kann den Vorgang sowohl im Voroperationsrückruf als auch im Post-Operation-Rückruf mithilfe von FLT_PREOP_DISALLOW_FSFILTER_IO bzw. FLT_POSTOP_DISALLOW_FSFILTER_IO ablehnen.

Das Dateisystem füllt das Feld "Information"nicht im IO_STATUS-Block aus. Filter sollten diesen Wert in ihren Postanrufen nicht überprüfen.

Weitere Informationen zu FSFilter-Rückrufvorgängen finden Sie im Referenzeintrag für FsRtlRegisterFileSystemFilterCallbacks.