FLT_PARAMETERS für IRP_MJ_CREATE Union

Artikel
02/07/2024

Die folgende Unionkomponente wird verwendet, wenn das Feld MajorFunction der FLT_IO_PARAMETER_BLOCK-Struktur für den Vorgang IRP_MJ_CREATE wird.

Syntax

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIO_SECURITY_CONTEXT     SecurityContext;
    ULONG                    Options;
    USHORT POINTER_ALIGNMENT FileAttributes;
    USHORT                   ShareAccess;
    USHORT POINTER_ALIGNMENT EaLength;
    PVOID                    EaBuffer;
    LARGE_INTEGER            AllocationSize;
  } Create;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Member

Die Create-Struktur von FLT_PARAMETERS enthält die folgenden Member.

SecurityContext: Zeiger auf eine IO_SECURITY_CONTEXT Struktur, die den Sicherheitskontext einer IRP_MJ_CREATE Anforderung darstellt, wobei:

Securitycontext->AccessState ist ein Zeiger auf eine ACCESS_STATE-Struktur , die den Betreffkontext des Objekts, gewährte Zugriffstypen und die verbleibenden gewünschten Zugriffstypen enthält.
Securitycontext->DesiredAccess ist eine ACCESS_MASK-Struktur , die die für die Datei angeforderten Zugriffsrechte angibt. Weitere Informationen finden Sie im DesiredAccess-Parameter für FltCreateFile.
Optionen: Bitmaske von Flags, die die Optionen angeben, die beim Erstellen oder Öffnen der Datei angewendet werden sollen, sowie die Aktion, die ausgeführt werden soll, wenn die Datei bereits vorhanden ist. Die niedrigen 24 Bits dieses Members entsprechen dem CreateOptions-ParameterFltCreateFile. Die hohen 8 Bits entsprechen dem CreateDisposition-ParameterFltCreateFile.
FileAttributes: Bitmaske von Attributen, die beim Erstellen oder Öffnen der Datei angewendet werden sollen. Weitere Informationen finden Sie im FileAttributes-Parameter zu FltCreateFile.
ShareAccess: Bitmaske der für die Datei angeforderten Freigabezugriffsrechte. Wenn dieser Parameter null ist, wird exklusiver Zugriff angefordert. Weitere Informationen finden Sie im ShareAccess-Parameter für FltCreateFile.
EaLength: Länge des Puffers, auf den das EaBuffer-Mitglied verweist, in Bytes. Weitere Informationen finden Sie im EaLength-Parameter zu FltCreateFile.
EaBuffer: Zeiger auf einen vom Aufrufer bereitgestellten, FILE_FULL_EA_INFORMATION strukturierten Puffer, der EA-Informationen (Extended Attribute) enthält, die auf die Datei angewendet werden sollen. Weitere Informationen finden Sie im EaBuffer-Parameter zu FltCreateFile.
AllocationSize: Gibt optional die anfängliche Zuordnungsgröße in Bytes für die Datei an. Ein Wert ohne Zero hat keine Auswirkung, es sei denn, die Datei wird erstellt, überschrieben oder ersetzt. Weitere Informationen finden Sie im AllocationSize-Parameter für FltCreateFile.

Hinweise

Die FLT_PARAMETERS-Struktur für den IRP_MJ_CREATE-Vorgang enthält die Parameter für einen IRP-basierten Create-Vorgang , der durch eine Rückrufdatenstruktur (FLT_CALLBACK_DATA) dargestellt wird. Sie ist in einer FLT_IO_PARAMETER_BLOCK-Struktur enthalten.

IRP_MJ_CREATE ist ein IRP-basierter Vorgang.