FsRtlPrepareMdlWriteDev, fonction (ntifs.h)
La routine FsRtlPrepareMdlWriteDev retourne une liste liée de listes de descripteurs de mémoire (MDLs) qui pointent vers la plage spécifiée de données de fichier mises en cache pour écrire des données directement dans le cache.
Syntaxe
BOOLEAN FsRtlPrepareMdlWriteDev(
[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
);
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] Length
Longueur en octets des données à lire à partir du cache.
[in] LockKey
Valeur associée à la plage d’octets à verrouiller. Si la plage à verrouiller chevauche une autre plage qui est déjà verrouillée avec un verrou non cluster ou si la plage à lire est une sous-plage d’une autre plage qui est déjà verrouillée non exclusivement, la valeur de ce paramètre doit être la clé de ce verrou non cluster. Le verrou doit être conservé par le processus parent du thread appelant. Sinon, ce paramètre n’a aucun effet.
[out] MdlChain
En sortie, un pointeur vers une liste liée de descripteurs de mémoire (MDLs) pointant vers la plage d’octets dans les données mises en cache.
[out] IoStatus
Pointeur vers une structure IO_STATUS_BLOCK qui, en sortie, contient l’état du transfert. Si l’opération réussit, IoStatus.Status est défini sur STATUS_SUCCESS. Sinon, il est défini sur un code d’erreur NTSTATUS approprié. IoStatus.Information est défini sur le nombre réel d’octets verrouillés par la routine.
[ in, optional ] DeviceObject
Pointeur vers un objet d’appareil sur lequel le fichier est ouvert.
Valeur de retour
La routine FsRtlPrepareMdlWriteDev retourne TRUE si l’opération réussit et FALSE en cas d’échec de l’opération.
Remarques
FsRtlPrepareMdlWriteDev est similaire à FsRtlCopyWrite, sauf que FsRtlPrepareMdlWriteDev ne copie pas de données dans le cache. Au lieu de cela, les pages physiques que l’appelant remplacera sont verrouillées en mémoire, et FsRtlPrepareMdlWriteDev retourne une ou plusieurs listes de descripteurs de mémoire (MDLs) qui pointent vers la plage d’octets spécifiée. Les pages verrouillées restent verrouillées jusqu’à ce que l’appelant appelle FsRtlMdlWriteCompleteDev.
Les pages vers lesquelles les DLL MDL pointent sont verrouillées en mémoire, mais ne sont pas mappées dans l’espace système. L’appelant peut effectuer ce mappage en appelant MmGetSystemAddressForMdlSafe.
Même si l’appel à FsRtlPrepareMdlWriteDev échoue, un ou plusieurs MDL peuvent avoir été alloués. L’appelant peut examiner la valeur de IoStatus.Information pour déterminer si cela s’est produit. S’il en a, l’appelant doit appeler FsRtlMdlWriteCompleteDev pour libérer les DLL allouées.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |