FLT_PARAMETERS für IRP_MJ_CREATE_MAILSLOT Union

Artikel
02/02/2024

Die folgende Struktur innerhalb der FLT_PARAMETERS Union wird verwendet, wenn das Feld MajorFunction der FLT_IO_PARAMETER_BLOCK-Struktur IRP_MJ_CREATE_MAILSLOT wird.

Syntax

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIO_SECURITY_CONTEXT     SecurityContext;
    ULONG                    Options;
    USHORT POINTER_ALIGNMENT Reserved;
    USHORT                   ShareAccess;
    PVOID                    Parameters;
  } CreateMailslot;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Member

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

SecurityContext: Zeiger auf eine IO_SECURITY_CONTEXT-Struktur , die den Sicherheitskontext einer IRP_MJ_CREATE_MAILSLOT-Anforderung darstellt, wobei Folgendes zu beachten ist:
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 das maillot angeforderten Zugriffsrechte angibt. Weitere Informationen finden Sie im DesiredAccess-Parameter von FltCreateMailslotFile.
Optionen: Bitmaske von Flags, die die Optionen angeben, die beim Erstellen oder Öffnen des Maillots angewendet werden sollen, sowie die Aktion, die ausgeführt werden soll, wenn das Maillot bereits vorhanden ist. Die niedrigen 24 Bits dieses Members entsprechen dem CreateOptions-Parameter für FltCreateMailslotFile. Die hohen 8 Bits entsprechen dem CreateDisposition-Parameter für FltCreateMailslotFile.
Reserviert: Reserviert; nicht verwenden.
ShareAccess: Bitmaske der für die Maillot-Datei angeforderten Freigabezugriffsrechte. Wenn dieser Parameter null ist, wird exklusiver Zugriff angefordert. Weitere Informationen finden Sie im ShareAccess-Parameter für FltCreateMailslotFile.
Parameter: Zeiger auf eine MAILSLOT_CREATE_PARAMETERS Struktur, die Informationen zu dem gerade erstellten oder geöffneten Maillot enthält.

Hinweise

FLT_PARAMETERS enthält eine CreateMailslot-Struktur , wenn der E/A-Vorgang IRP_MJ_CREATE_MAILSLOT ist. Der E/A-Vorgang wird durch eine FLT_CALLBACK_DATA-Struktur dargestellt, wobei die Vorgangsparameter in der FLT_IO_PARAMETER_BLOCK-Struktur enthalten sind, auf die der Iopb-Parameter der Rückrufdaten verweist.

Ein Dateisystem-Minifiltertreiber, der eine Rückrufroutine für IRP_MJ_CREATE_MAILSLOT-Vorgänge registriert hat, sollte alle erforderlichen Verarbeitungs- und Rückgabevorgänge ausführen.

Beachten Sie, dass die Felder in der CreateMailslot-Struktur mit denen für die Create-Struktur übereinstimmen müssen.

IRP_MJ_CREATE_MAILSLOT ist ein IRP-basierter Vorgang.