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

O método ReadTypedDataPhysical lê o valor de uma variável da memória física do computador de destino.

Sintaxe

HRESULT ReadTypedDataPhysical(
  [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 endereço físico na memória do computador de 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 da variável.

[out] Buffer

Recebe os dados que foram lidos.

[in] BufferSize

Especifica o tamanho em bytes do Buffer de buffer. Esse é o número máximo de bytes que serão 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 armazenar 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

Esse método só está disponível na depuração do modo kernel.

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 ReadPhysical.

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)