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.

Nota Si se especifica el valor FlushType MmFlushForDelete y hay uno o varios sondeos de escritura pendientes en la sección de datos del archivo, 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

Consulte también

CcPurgeCacheSection