Función MmFlushImageSection (ntifs.h)
El MmFlushImageSection rutina 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 abre 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.
Observaciones
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 rutina de distribución de IRP_MJ_SET_INFORMATION o IRP_MJ_CLEANUP, 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 de 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 que los escritores del sistema de archivos estudien la forma en que se usa esta rutina en el ejemplo FASTFAT.
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 | < DISPATCH_LEVEL |