Compartilhar via


Método IDebugSymbols3::ReadTypedDataVirtual (dbgeng.h)

O método ReadTypedDataVirtual lê o valor de uma variável na memória virtual do destino.

Sintaxe

HRESULT ReadTypedDataVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG64 Module,
  [in]            ULONG   TypeId,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Parâmetros

[in] Offset

Especifica o local no espaço de endereço virtual do destino da variável a ser lida.

[in] Module

Especifica o endereço base do módulo que contém o tipo da variável.

[in] TypeId

Especifica a ID de tipo do tipo.

[out] Buffer

Recebe os dados lidos.

[in] BufferSize

Especifica o tamanho em bytes do buffer Buffer. Esse é o número máximo de bytes a serem lidos.

[out, optional] BytesRead

Recebe o número de bytes que foram lidos. Se BytesRead for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
S_FALSE
O método foi bem-sucedido. No entanto, o Buffer de buffer não era grande o suficiente para conter todos os dados e foi truncado.
 

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

Comentários

O número de bytes que esse método tenta ler é o menor do tamanho do buffer e do tamanho da variável.

Esse é um método de conveniência. O mesmo resultado pode ser obtido chamando GetTypeSize e ReadVirtual.

Para obter mais informações sobre tipos, consulte Tipos.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)