Método IDebugDataSpaces3::WriteVirtualUncached (dbgeng.h)

Artigo
02/26/2024

O método WriteVirtualUncached grava dados no espaço de endereço virtual do destino.

Sintaxe

HRESULT WriteVirtualUncached(
  [in]            ULONG64 Offset,
  [in]            PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesWritten
);

Parâmetros

[in] Offset

Especifica o local no espaço de endereço virtual do destino a ser gravado.

[in] Buffer

Especifica o buffer do qual gravar a memória.

[in] BufferSize

Especifica o tamanho em bytes do buffer. Esse também é o número de bytes solicitados a serem gravados.

[out, optional] BytesWritten

Recebe o número de bytes que foram realmente gravados. Se estiver definido como NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi pelo menos parcialmente bem-sucedido. BytesWritten indica o número de bytes gravados com êxito, que pode ser menor que BufferSize.

Comentários

Esse método grava o buffer na memória no espaço de endereço virtual do destino.

Esse método se comporta de forma idêntica ao WriteVirtual, exceto pelo fato de evitar o uso do cache de memória virtual. Portanto, é útil para ler memória virtual inerentemente volátil, como áreas de dispositivo mapeadas pela memória, sem contaminar ou invalidar o cache.