Función MmFlushImageSection (ntifs.h)
La rutina MmFlushImageSection vacía la sección de imagen de un archivo.
Sintaxis
BOOLEAN MmFlushImageSection(
PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] MMFLUSH_TYPE FlushType
);
Parámetros
SectionObjectPointer
Puntero a una estructura que contiene los punteros de objeto de sección del objeto de archivo.
[in] FlushType
Especifica el motivo de la operación de vaciado. Puede ser uno de los valores enumerados en la tabla siguiente.
Valor FlushType | Significado |
---|---|
MmFlushForDelete | El archivo se está eliminando. |
MmFlushForWrite | El archivo se está abriendo para el acceso de escritura. |
Valor devuelto
MmFlushImageSection devuelve TRUE si la operación de vaciado se realiza correctamente o si no existe ninguna sección de imagen para el archivo; De lo contrario , MmFlushImageSection devuelve FALSE.
Comentarios
Un sistema de archivos debe llamar a la rutina MmFlushImageSection antes de eliminar un archivo o abrir un archivo para el acceso de escritura.
Antes de eliminar un archivo, el sistema de archivos debe llamar a MmFlushImageSection desde su IRP_MJ_SET_INFORMATION o IRP_MJ_CLEANUP rutina de distribución, pasando MmFlushForDelete para el parámetro FlushType .
Al abrir un archivo para el acceso de escritura, el sistema de archivos debe llamar a MmFlushImageSection desde su rutina de distribución IRP_MJ_CREATE, pasando MmFlushForWrite para el parámetro FlushType .
Si no hay vistas asignadas de la sección de imagen, MmFlushImageSection destruye la sección de imagen y devuelve las páginas usadas a la lista gratuita.
Antes de usar MmFlushImageSection, se recomienda encarecidamente a los escritores del sistema de archivos que estudien la forma en que esta rutina se usa en la muestra FASTFAT.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Universal |
Encabezado | ntifs.h (incluya Ntifs.h) |
Library | NtosKrnl.lib |
Archivo DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |