Función FsRtlPrepareMdlWriteDev (ntifs.h)
La rutina FsRtlPrepareMdlWriteDev devuelve una lista vinculada de listas de descriptores de memoria (MDL) que apuntan al intervalo especificado de datos de archivos almacenados en caché para escribir datos directamente en la memoria caché.
Sintaxis
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
);
Parámetros
[in] FileObject
Puntero al objeto de archivo.
[in] FileOffset
Puntero a un valor que especifica el desplazamiento de bytes inicial dentro de la memoria caché que contiene los datos.
[in] Length
Longitud en bytes de los datos que se van a leer de la memoria caché.
[in] LockKey
Valor asociado al intervalo de bytes que se va a bloquear. Si el intervalo para bloquear se superpone a otro intervalo que ya está bloqueado con un bloqueo noclusivo, o si el intervalo que se va a leer es un subrango de otro rango que ya está bloqueado de forma no exclusiva, el valor de este parámetro debe ser la clave para ese bloqueo noclusivo. El proceso primario del subproceso que realiza la llamada debe mantener el bloqueo. De lo contrario, este parámetro no tiene ningún efecto.
[out] MdlChain
En la salida, un puntero a una lista vinculada de listas de descriptores de memoria (MDL) que apuntan al intervalo de bytes dentro de los datos almacenados en caché.
[out] IoStatus
Puntero a una estructura de IO_STATUS_BLOCK que, en la salida, contiene el estado de la transferencia. Si la operación se realiza correctamente, ioStatus.Status se establece en STATUS_SUCCESS. De lo contrario, se establece en un código de error NTSTATUS adecuado. ioStatus.Information se establece en el número real de bytes que la rutina bloqueó correctamente.
[ in, optional ] DeviceObject
Puntero a un objeto de dispositivo en el que se abre el archivo.
Valor devuelto
La rutina de FsRtlPrepareMdlWriteDev devuelve TRUE si la operación se realiza correctamente y FALSE si se produce un error en la operación.
Observaciones
FsRtlPrepareMdlWriteDev es similar a FsRtlCopyWrite, excepto que FsRtlPrepareMdlWriteDev no copia datos en la memoria caché. En su lugar, las páginas físicas que el autor de la llamada sobrescribirá están bloqueadas en la memoria y FsRtlPrepareMdlWriteDev devuelve una o varias listas de descriptores de memoria (MDL) que apuntan al intervalo de bytes especificado. Las páginas bloqueadas permanecen bloqueadas hasta que el autor de la llamada llama a FsRtlMdlWriteCompleteDev.
Las páginas a las que apuntan los MDL están bloqueadas en la memoria, pero no están asignadas en el espacio del sistema. El autor de la llamada puede realizar esta asignación llamando a MmGetSystemAddressForMdlSafe.
Incluso si se produce un error en la llamada a FsRtlPrepareMdlWriteDev, es posible que se hayan asignado una o varias MDL. El autor de la llamada puede examinar el valor de IoStatus.Information para determinar si se ha producido esto. Si lo tiene, el autor de la llamada debe llamar a FsRtlMdlWriteCompleteDev para liberar las MDL asignadas.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de |
Universal |
| encabezado de |
ntifs.h (incluya Ntifs.h) |
| biblioteca de |
NtosKrnl.lib |
| DLL de |
NtosKrnl.exe |
| irQL | <= APC_LEVEL |