FLT_PARAMETERS für IRP_MJ_MDL_READ Union

Artikel
02/07/2024

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

Syntax

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

Member

MdlRead: Struktur, die die folgenden Member enthält.
FileOffset: Byte wird in der zwischengespeicherten Datei gestartet.
Länge: Länge der Daten, die aus der zwischengespeicherten Datei gelesen werden sollen, in Bytes.
Schlüssel: Schlüsselwert, der einer Bytebereichssperre für die Zieldatei zugeordnet ist. Wenn sich der zu lesende Bereich überschneidet 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 aus einer oder mehreren Speicherdeskriptorlisten (Memory Descriptor Lists, MDL) empfängt, die die Seiten beschreiben, die die zu lesenden Daten enthalten.

Hinweise

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

Wenn eine schnelle E/A-IRP_MJ_MDL_READ-Anforderung fehlschlägt, bestimmt der E/A-Aussteller, wie die Anforderung erneut ausgeführt werden soll. Ein Minifilter erhält möglicherweise nicht immer eine IRP-basierte IRP_MJ_MDL_READ. Für instance kann die IRP-Anforderung als IRP_MJ_READ/IRP_MN_MDL erneut ausgestellt werden.

IRP_MJ_MDL_READ ist ein schneller E/A-Vorgang.