FLT_PARAMETERS für IRP_MJ_PREPARE_MDL_WRITE Union

Artikel
06/05/2024

Der folgende FLT_PARAMETERS Unionsmember wird verwendet, wenn FLT_IO_PARAMETER_BLOCK.MajorFunction IRP_MJ_PREPARE_MDL_WRITE ist.

Syntax

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    LARGE_INTEGER           FileOffset;
    ULONG POINTER_ALIGNMENT Length;
    ULONG POINTER_ALIGNMENT Key;
    PMDL                    *MdlChain;
  } PrepareMdlWrite;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Member

PrepareMdlWrite: Struktur, die die folgenden Mitglieder enthält.
FileOffset: Byte wird innerhalb der zwischengespeicherten Datei gestartet.
Länge: Länge der Daten, die aus der zwischengespeicherten Datei geschrieben werden sollen, in Bytes.
Schlüssel: Schlüsselwert, der einer Bytebereichssperre in der Zieldatei zugeordnet ist. Wenn der zu schreibende Bereich überlappt oder ein Unterbereich eines exklusiv gesperrten Bereichs innerhalb der Datei ist, muss dieser Parameter der Schlüssel für diese exklusive Sperre sein. Die exklusive Sperre muss vom übergeordneten Prozess des aufrufenden Threads gehalten werden; andernfalls wird dieser Parameter ignoriert.
MdlChain: Zeiger auf eine Variable, die einen Zeiger auf eine Kette von einer oder mehreren Memory Descriptor Lists (MDL) erhält, die die Seiten beschreiben, die die zu schreibenden Daten enthalten.

Hinweise

IRP_MJ_PREPARE_MDL_WRITE ist ein schneller E/A-Vorgang. Es funktioniert genauso wie IRP_MJ_WRITE + IRP_MN_MDL mit Ausnahme des folgenden Unterschieds:

Der IRP-basierte Vorgang richtet die Zwischenspeicherung für die Datei ein, wenn er noch nicht zwischengespeichert wird, bevor die MDL-Arbeit ausgeführt wird.
Der schnelle E/A-Vorgang schlägt fehl, wenn die Datei noch nicht zwischengespeichert ist.

Die FLT_PARAMETERS-Struktur für IRP_MJ_PREPARE_MDL_WRITE-Vorgänge enthält die Parameter für einen schnellen E/A-PrepareMdlWrite-Vorgang. Der Vorgang wird durch eine Rückrufdatenstruktur (FLT_CALLBACK_DATA) dargestellt. Sie ist in einer FLT_IO_PARAMETER_BLOCK-Struktur enthalten, wobei die Parameter des Vorgangs in der FLT_IO_PARAMETER_BLOCK-Struktur, auf die Iopb verweist.

Wenn bei einer schnellen E/A-IRP_MJ_PREPARE_MDL_WRITE-Anforderung ein Fehler auftritt, bestimmt der Aussteller der E/A, wie die Anforderung erneut ausgeführt werden soll. Die Anforderung kann z. B. mit IRP_MJ_WRITE + IRP_MN_MDL als IRP-basierten Vorgang neu bereitgestellt werden.