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

Artigo
02/06/2025

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 do tipo do tipo da variável.

[out] Buffer

Recebe os dados que foram lidos.

[in] BufferSize

Especifica o tamanho em bytes do buffer 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.

Valor de retorno

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 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 de Valores Retornados para obter mais detalhes.

Observações

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Compartilhar via