Função RtlFlushNonVolatileMemory (ntddk.h)

Artigo
02/07/2025

A rotina RtlFlushNonVolatileMemory libera de forma ideal a região de memória não volátil fornecida.

Sintaxe

NTSYSAPI NTSTATUS RtlFlushNonVolatileMemory(
  PVOID  NvToken,
  PVOID  NvBuffer,
  SIZE_T Size,
  ULONG  Flags
);

Parâmetros

NvToken

Um ponteiro para uma estrutura opaca que tem informações sobre várias propriedades da região de memória não volátil que rtlGetNonVolatileToken havia retornado.

NvBuffer

Um ponteiro para a memória não volátil a ser liberada. Devem ser endereços de usuário obtidos de um objeto de mapeamento de arquivo.

Size

O comprimento, em bytes, do buffer de memória não volátil NvBuffer aponta para.

Flags

Um dos seguintes sinalizadores pode ser especificado:

Sinalizadores	Significado
FLUSH_NV_MEMORY_IN_FLAG_NO_DRAIN	Especifica que essa rotina não precisa esperar que a liberação escorra.

Valor de retorno

A rotina RtlFreeNonVolatileToken retorna um dos códigos de status:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	NvToken é um ponteiro ou token inválido.
STATUS_SUCCESS	A solicitação foi bem-sucedida.

Observações

Essa rotina rtlFlushNonVolatileMemory também pode adicionar mais contexto a NvToken para ajudar os verificadores. Atualmente, essa rotina não tem suporte para o Windows Server até a próxima versão principal do Windows Server.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1703
servidor com suporte mínimo	Nenhum com suporte
da Plataforma de Destino	Windows
cabeçalho	ntddk.h (inclua Winnt.h)

Consulte também

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemoryRanges

rtlFreeNonVolatileToken

rtlGetNonVolatileToken

rtlWriteNonVolatileMemory

Partilhar via