FsRtlMdlWriteCompleteDev, fonction (ntifs.h)

Article
12/20/2024

La routine FsRtlMdlWriteCompleteDev libère les ressources qui FsRtlPrepareMdlWriteDev allouées.

Syntaxe

BOOLEAN FsRtlMdlWriteCompleteDev(
  [in]             PFILE_OBJECT   FileObject,
  [in]             PLARGE_INTEGER FileOffset,
  [in]             PMDL           MdlChain,
  [ in, optional ] PDEVICE_OBJECT DeviceObject
);

Paramètres

[in] FileObject

Pointeur vers l’objet fichier.

[in] FileOffset

Pointeur vers une valeur qui spécifie le décalage d’octets de départ dans le cache qui contient les données.

[in] MdlChain

Pointeur vers une liste liée de descripteurs de mémoire (MDLs) qui FsRtlPrepareMdlWriteDev allouée.

[ in, optional ] DeviceObject

Pointeur vers un objet d’appareil sur lequel le fichier est ouvert.

Valeur de retour

La routine FsRtlMdlWriteCompleteDev retourne TRUE si l’opération réussit et FALSE si l’opération échoue ou si l’indicateur de FO_WRITE_THROUGH est défini dans l’objet fichier.

Remarques

La routine FsRtlMdlWriteCompleteDev libère les listes de descripteurs de mémoire (MDLs) qui FsRtlPrepareMdlWriteDev allouées et déverrouille la mémoire du cache qui FsRtlPrepareMdlWriteDev verrouillée.

Si l’indicateur FO_WRITE_THROUGH est défini sur l’objet de fichier pointé par le paramètre FileObject, FsRtlMdlWriteCompleteDev vide immédiatement la mémoire mise en cache sur le disque. Cette opération de vidage entre à nouveau le système de fichiers et peut entraîner FsRtlMdlWriteCompleteDev déclencher une exception si l’opération de vidage échoue.

Chaque appel à FsRtlPrepareMdlWriteDev doit être suivi d’un appel à FsRtlMdlWriteCompleteDev.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Voir aussi

FsRtlPrepareMdlWriteDev

Partager via