Fonction FsRtlMdlWriteCompleteDev (ntifs.h)
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) |