FLT_PARAMETERS für IRP_MJ_QUERY_OPEN Union

Artikel
03/05/2024

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;

Member

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. Das FileInformationClass-Mitglied gibt den Typ der Informationen an, die der Aufrufer anfordert.
Länge: Ein Zeiger auf die Größe des Puffers in Bytes, auf den durch FileInformation verwiesen wird.

FileInformationClass: Gibt den Typ der über die Datei zurückzugebenden Informationen im Puffer an, 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.

FILE_INFORMATION_CLASS-Wert	Art der zurückgegebenen Informationen
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.

Hinweise

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 in seinem Pre-Operation-Callback als auch in seinem Post-Operation-Callback mit FLT_PREOP_DISALLOW_FSFILTER_IO bzw. FLT_POSTOP_DISALLOW_FSFILTER_IO zurückweisen.

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

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