Fonction FsRtlMdlWriteCompleteDev (ntifs.h)

Article
02/26/2024

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

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 de fichier.

[in] FileOffset

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

[in] MdlChain

Pointeur vers une liste liée de listes de descripteurs de mémoire (MDL) que FsRtlPrepareMdlWriteDev a allouées.

[ in, optional ] DeviceObject

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

Valeur retournée

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

Remarques

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

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

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	ntifs.h (inclure 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