Função RtlWriteNonVolatileMemory (ntddk.h)

Artigo
02/07/2025

A rotina RtlWriteNonVolatileMemory copia o conteúdo de um buffer de origem para um buffer de memória de destino não volátil.

Sintaxe

NTSYSAPI NTSTATUS RtlWriteNonVolatileMemory(
  PVOID      NvToken,
  VOID       *NvDestination,
  const VOID *Source,
  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.

NvDestination

Um ponteiro para o buffer de destino não volátil para o qual copiar.

Source

Um ponteiro para o buffer de origem do qual copiar.

Size

O comprimento, em bytes, da operação de cópia.

Flags

Reservado para uso futuro.

Valor de retorno

A rotina RtlWriteNonVolatileMemory retorna um dos seguintes:

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

Este é um RtlCopyMemory equivalente à memória não volátil que o valor agregado só tem o verificador habilitado. Quando o verificador está habilitado, os intervalos modificados podem ser acompanhados em NvToken e podem ser relatados em rtlFreeNonVolatileToken se uma liberação não for chamada para uma gravação. 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)