Función ZwFlushBuffersFile (ntifs.h)

Un controlador de filtro del sistema de archivos llama a la rutina ZwFlushBuffersFile para enviar una solicitud de vaciado para el archivo especificado al sistema de archivos.

Sintaxis

NTSYSAPI NTSTATUS ZwFlushBuffersFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock
);

Parámetros

[in] FileHandle

Identificador devuelto por ZwCreateFile o ZwOpenFile para el archivo cuyos búferes se vaciarán. Este parámetro es necesario y no se puede null.

[out] IoStatusBlock

Dirección del bloque de estado de E/S del autor de la llamada. Este parámetro es necesario y no se puede null.

Valor devuelto

ZwFlushBuffersFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_MEDIA_WRITE_PROTECTED	El archivo reside en un volumen protegido por escritura; se trata de un código de error.
STATUS_VOLUME_DISMOUNTED	El archivo reside en un volumen que no está montado actualmente; se trata de un código de error.

Observaciones

Un controlador de filtro del sistema de archivos puede llamar a ZwFlushBuffersFile para emitir una solicitud de IRP_MJ_FLUSH_BUFFERS al sistema de archivos para un archivo determinado. La operación de vaciado es sincrónica.

Los controladores de minifiltro deben llamar a FltFlushBuffers en lugar de llamar a ZwFlushBuffersFile.

Los autores de llamadas de ZwFlushBuffersFile deben ejecutarse en IRQL = PASSIVE_LEVEL y con API de kernel especiales habilitadas.

En el caso de las llamadas desde controladores en modo kernel, las versiones **Nt*Xxx*** y **Zw*Xxx*** de una rutina de Servicios del sistema nativo de Windows pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones **Nt*Xxx*** y **Zw*Xxx*** de una rutina, vea [Using Nt and Zw Versions of the Native System Services Routines](/windows-hardware/drivers/kernel/using-nt-and-zw-versions-of-the-native-system-services-routines).

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL (consulte la sección Comentarios)
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

fltFlushBuffers de

IRP_MJ_FLUSH_BUFFERS

usar versiones Nt y Zw de las rutinas de servicios del sistema nativo

ZwCreateFile

ZwOpenFile