Método IDebugDataSpaces4::GetOffsetInformation (dbgeng.h)

Artigo
02/27/2024

O método GetOffsetInformation fornece informações gerais sobre um endereço no espaço de dados de um processo.

Sintaxe

HRESULT GetOffsetInformation(
  [in]            ULONG   Space,
  [in]            ULONG   Which,
  [in]            ULONG64 Offset,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parâmetros

[in] Space

Especifica o espaço de dados ao qual o parâmetro Offset se aplica. Os valores permitidos dependem do parâmetro Qual .

[in] Which

Especifica quais informações sobre os dados estão sendo consultadas. Isso determina os valores possíveis para Espaço e o tipo dos dados retornados no Buffer. Os valores possíveis são:

DEBUG_OFFSINFO_VIRTUAL_SOURCE

Retorna a origem da memória virtual do destino em Offset. É aqui que o mecanismo de depurador lê a memória. O espaço deve ser definido como DEBUG_DATA_SPACE_VIRTUAL. Um ULONG é retornado ao Buffer. Esse ULONG pode obter os valores listados na tabela a seguir.

Valor	Descrição
DEBUG_VSOURCE_INVALID	O deslocamento de deslocamento não está disponível no espaço de endereço virtual do processo. Isso pode significar que o endereço é inválido ou que a memória não está disponível , por exemplo, um arquivo de despejo de memória pode não conter toda a memória do processo ou do kernel.
DEBUG_VSOURCE_DEBUGGEE	A memória virtual no deslocamento de deslocamento é fornecida pelo destino.
DEBUG_VSOURCE_MAPPED_IMAGE	O mecanismo de depurador lê a memória virtual do destino em Deslocamento de um arquivo de imagem local. Geralmente, esse é o caso em arquivos de minidump em que as imagens do módulo não são incluídas no arquivo de despejo e, em vez disso, são carregadas pelo mecanismo do depurador.

[in] Offset

Especifica o deslocamento no espaço de dados do destino para o qual as informações são retornadas.

[out, optional] Buffer

Especifica o buffer para receber as informações. O tipo dos dados retornados depende do valor de Qual. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em bytes, do buffer de buffer .

[out, optional] InfoSize

Recebe o tamanho, em bytes, das informações retornadas. Se InfoSize for 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 bem-sucedido.

Requisitos

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

Compartilhar via