FltFastIoPrepareMdlWrite-Funktion (fltkernel.h)
Die FltFastIoPrepareMdlWrite Routine gibt eine verknüpfte Liste der Speicherdeskriptorlisten (MDLs) zurück, die auf den angegebenen Bereich zwischengespeicherter Dateidaten verweisen, um Daten direkt in den Cache zu schreiben.
Syntax
BOOLEAN FLTAPI FltFastIoPrepareMdlWrite(
PFLT_INSTANCE InitiatingInstance,
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] ULONG Length,
[in] ULONG LockKey,
[out] PMDL *MdlChain,
[out] PIO_STATUS_BLOCK IoStatus
);
Parameter
InitiatingInstance
Undurchsichtiger Instanzzeiger für den Aufrufer. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
[in] FileObject
Ein Zeiger auf das Dateiobjekt.
[in] FileOffset
Ein Zeiger auf einen Wert, der den Anfangsbyte-Offset innerhalb des Caches angibt, der 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 nicht exklusive 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), die auf den Bytebereich innerhalb der zwischengespeicherten Daten verweisen.
[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.
Rückgabewert
Die FltFastIoPrepareMdlWrite Routine gibt TRUE- zurück, wenn der Vorgang erfolgreich ist, und FALSE, wenn der Vorgang fehlschlägt.
Bemerkungen
FltFastIoPrepareMdlWrite ähnelt FsRtlCopyWrite, außer dass FltFastIoPrepareMdlWrite keine Daten in den Cache kopiert. Stattdessen werden die physischen Seiten, die vom Aufrufer überschrieben werden, im Arbeitsspeicher gesperrt, und FltFastIoPrepareMdlWrite eine oder mehrere Speicherdeskriptorlisten (MDLs) zurückgibt, die auf den angegebenen Bytebereich verweisen. Die gesperrten Seiten bleiben gesperrt, bis der Aufrufer FltFastIoMdlWriteCompleteaufruft.
Die Seiten, auf die die MDLs verweisen, sind im Arbeitsspeicher gesperrt, werden jedoch nicht im Systembereich zugeordnet. Der Aufrufer kann diese Zuordnung ausführen, indem MmGetSystemAddressForMdlSafeaufgerufen wird.
Selbst wenn der Aufruf von FltFastIoPrepareMdlWrite fehlschlägt, wurde möglicherweise mindestens ein MDLs zugewiesen. Der Aufrufer kann den Wert IoStatus.Information untersuchen, um festzustellen, ob dies aufgetreten ist. Falls ja, muss der Aufrufer FltFastIoMdlWriteComplete- aufrufen, um die zugeordneten MDLs freizuweisen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |