Função ZwFlushBuffersFile (ntifs.h)

A rotina de ZwFlushBuffersFile é chamada por um driver de filtro do sistema de arquivos para enviar uma solicitação de liberação do 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.

Valor de retorno

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.

Observações

Um driver de filtro do sistema de arquivos pode chamar ZwFlushBuffersFile 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 ZwFlushBuffersFile.

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

Observação 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 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 Vista
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)
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte também

FltFlushBuffers

IRP_MJ_FLUSH_BUFFERS

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

ZwCreateFile

ZwOpenFile