Compartilhar via


Função RtlWriteNonVolatileMemory (ntddk.h)

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.

Retornar valor

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.

Comentários

Esse é um equivalente rtlCopyMemory para memória não volátil que o valor adicionar é apenas com o verificador habilitado. Quando o verificador está habilitado, os intervalos modificados podem ser rastreados em NvToken e podem ser relatados em RtlFreeNonVolatileToken se uma liberação não for chamada para gravação. Atualmente, não há suporte para essa rotina no Windows Server até a próxima versão principal do Windows Server.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho ntddk.h (inclua Winnt.h)

Confira também

RtlCopyMemory

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlGetNonVolatileToken