FsRtlMdlReadDev-Funktion (ntifs.h)

Die FsRtlMdlReadDev Routine gibt eine Speicherdeskriptorliste (MDL) zurück, die direkt auf den angegebenen Bytebereich im Dateicache verweist.

Syntax

BOOLEAN FsRtlMdlReadDev(
  [in]             PFILE_OBJECT     FileObject,
  [in]             PLARGE_INTEGER   FileOffset,
  [in]             ULONG            Length,
  [in]             ULONG            LockKey,
  [out]            PMDL             *MdlChain,
  [out]            PIO_STATUS_BLOCK IoStatus,
  [ in, optional ] PDEVICE_OBJECT   DeviceObject
);

Parameter

[in] FileObject

Ein Zeiger auf ein Dateiobjekt für die zwischengespeicherte Datei.

[in] FileOffset

Ein Zeiger auf eine Variable, die den Anfangsbyte-Offset in der zwischengespeicherten Datei angibt, die die Daten enthält.

[in] Length

Die Länge in Byte der Daten, die aus dem Cache gelesen werden sollen.

[in] LockKey

Ein Wert, der dem zu sperrenden Bytebereich zugeordnet ist. Wenn der zu sperrende Bereich einen anderen Bereich überlappt, der bereits mit einer nicht exklusiven Sperre gesperrt ist, oder wenn der zu lesende Bereich ein Unterbereich eines anderen Bereichs ist, der bereits nicht exklusiv gesperrt ist, muss der Wert in diesem Parameter der Schlüssel für diese nichtexklusive Sperre sein. Die Sperre muss vom übergeordneten Prozess des aufrufenden Threads gehalten werden. Andernfalls hat dieser Parameter keine Auswirkung.

[out] MdlChain

Bei der Ausgabe zeigt ein Zeiger auf eine verknüpfte Liste der Speicherdeskriptorlisten (MDLs).

[out] IoStatus

Ein Zeiger auf eine IO_STATUS_BLOCK Struktur, die bei der Ausgabe den Status der Übertragung enthält. Wenn der Vorgang erfolgreich ist, wird IoStatus.Status auf STATUS_SUCCESS festgelegt. Andernfalls wird er auf einen entsprechenden NTSTATUS-Fehlercode festgelegt. IoStatus.Information wird auf die tatsächliche Anzahl der Bytes festgelegt, die die Routine erfolgreich gesperrt hat.

[ in, optional ] DeviceObject

Ein Zeiger auf ein Geräteobjekt, auf dem die Datei geöffnet wird.

Rückgabewert

Die FsRtlMdlReadDev Routine gibt TRUE zurück, wenn der Vorgang erfolgreich ist, und FALSE, wenn der Vorgang fehlschlägt.

Bemerkungen

Die FsRtlMdlReadDev Routine umgehen den üblichen IRP-Mechanismus und gibt eine verknüpfte Liste der Speicherdeskriptorlisten (MDL) zurück, die der Aufrufer verwenden kann, um direkt auf die zwischengespeicherten Dateidaten zuzugreifen. Dieser Vorgang kopiert oder puffert keine Daten und ist daher viel schneller als ein normaler Lesevorgang.

Die Routine ähnelt CcMdlRead und FltFastIoMdlRead. FltFastIoMdlRead, CcMdlReadund FsRtlMdlReadDev die Seiten sperren, die die zwischengespeicherten Dateidaten enthalten, um zu verhindern, dass das System diese Seiten in die Seitendatei wechselt. Die Seiten bleiben im Arbeitsspeicher gesperrt, bis der Aufrufer die FsRtlMdlReadCompleteDev Routine aufruft.

Anforderungen

Siehe auch

CcMdlRead-

FsRtlMdlReadCompleteDev-

FsRtlMdlReadEx-