Função ZwFlushBuffersFile (ntifs.h)

A rotina ZwFlushBuffersFile é chamada por um driver de filtro do sistema de arquivos para enviar uma solicitação de liberação para o arquivo especificado para o sistema de arquivos.

Sintaxe

NTSYSAPI NTSTATUS ZwFlushBuffersFile(
  [in]  HANDLE           FileHandle,
  [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.

[out] IoStatusBlock

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

Retornar valor

ZwFlushBuffersFile retorna STATUS_SUCCESS ou um valor 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.

Comentários

Um driver de filtro do sistema de arquivos pode chamar ZwFlushBuffersFile para emitir uma solicitação de IRP_MJ_FLUSH_BUFFERS para o 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 ZwFlushBuffersFile.

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

Nota Se a chamada para a função ZwFlushBuffersFile ocorrer no modo de usuário, você deverá usar o nome "NtFlushBuffersFile" em vez de "ZwFlushBuffersFile".

 

Para chamadas de drivers de modo kernel, as versões **Nt*Xxx*** e **Zw*Xxx*** de uma rotina dos Serviços do 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
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (consulte a seção Comentários)
Regras de conformidade da DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

FltFlushBuffers

IRP_MJ_FLUSH_BUFFERS

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

ZwCreateFile

ZwOpenFile