Função ZwFlushBuffersFileEx (ntifs.h)

A rotina de ZwFlushBuffersFileEx é chamada por um driver de filtro do sistema de arquivos para enviar uma solicitação de liberação de um determinado arquivo para o sistema de arquivos. Um sinalizador de operação de liberação opcional pode ser definido para controlar como os dados do arquivo são gravados no armazenamento.

Sintaxe

NTSYSAPI NTSTATUS ZwFlushBuffersFileEx(
  [in]  HANDLE           FileHandle,
        ULONG            FLags,
        PVOID            Parameters,
        ULONG            ParametersSize,
  [out] PIO_STATUS_BLOCK IoStatusBlock
);

Parâmetros

[in] FileHandle

Identificador retornado por ZwCreateFile ou ZwOpenFile para o arquivo cujos buffers serão liberados. Esse parâmetro é necessário e não pode ser NULL.

FLags

Liberar sinalizadores de operação. Flags pode ser 0 ou um dos valores a seguir.

Valor	Significado
FLUSH_FLAGS_FILE_DATA_ONLY	Se o arquivo estiver em um sistema de arquivos NTFS, os dados do arquivo no cache de arquivos serão gravados. Nenhum metadado é gravado e o armazenamento subjacente não é sincronizado para liberar seu cache. Esse sinalizador não é válido com identificadores de volume.
FLUSH_FLAGS_NO_SYNC	Se o arquivo estiver em um sistema de arquivos NTFS, os dados do arquivo e os metadados no cache de arquivos serão gravados. O armazenamento subjacente não é sincronizado para liberar seu cache. Esse sinalizador não é válido com identificadores de volume.

 

Parameters

Endereço do bloco de status de E/S do chamador. Esse parâmetro é necessário e não pode ser NULL.

ParametersSize

O tamanho, em bytes, do bloco de parâmetros.

[out] IoStatusBlock

Endereço do bloco de status de E/S do chamador. Esse parâmetro é necessário e não pode ser NULL.

Valor de retorno

ZwFlushBuffersFileEx retorna STATUS_SUCCESS ou um valor de NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_MEDIA_WRITE_PROTECTED	O arquivo reside em um volume protegido por gravação; este é um código de erro.
STATUS_VOLUME_DISMOUNTED	O arquivo reside em um volume que não está montado no momento; este é um código de erro.
STATUS_ACCESS_DENIED	O arquivo não tem acesso de gravação nem acréscimo.

Observações

Um driver de filtro do sistema de arquivos pode chamar ZwFlushBuffersFileEx para emitir uma solicitação IRP_MJ_FLUSH_BUFFERS ao sistema de arquivos para um determinado arquivo. A operação de liberação é síncrona.

Os drivers de minifiltro devem chamar fltFlushBuffers em vez de chamar ZwFlushBuffersFileEx .

Os chamadores de ZwFlushBuffersFileEx devem estar em execução em IRQL = PASSIVE_LEVEL e com APCs de kernel especiais habilitadas.

Para chamadas de drivers no modo kernel, as versões **Nt*Xxx*** e **Zw*Xxx*** de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões **Nt*Xxx*** e **Zw*Xxx*** de uma rotina, consulte [Usando versões Nt e Zw das rotinas de serviços do sistema nativo](/windows-hardware/drivers/kernel/using-nt-and-zw-versions-of-the-native-system-services-routines).

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8.
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (consulte a seção Comentários.)

Consulte também

FltFlushBuffers

IRP_MJ_FLUSH_BUFFERS

usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwCreateFile

ZwOpenFile