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

Artigo
02/06/2025

O método SearchVirtual pesquisa a memória virtual do destino em busca de um padrão de bytes especificado.

Sintaxe

HRESULT SearchVirtual(
  [in]  ULONG64  Offset,
  [in]  ULONG64  Length,
  [in]  PVOID    Pattern,
  [in]  ULONG    PatternSize,
  [in]  ULONG    PatternGranularity,
  [out] PULONG64 MatchOffset
);

Parâmetros

[in] Offset

Especifica o local no espaço de endereço virtual do destino para começar a pesquisar o padrão.

[in] Length

Especifica até que ponto pesquisar o padrão. Uma correspondência bem-sucedida requer que todo o padrão seja encontrado antes que Bytes de comprimento tenham sido examinados.

[in] Pattern

Especifica o padrão a ser pesquisado.

[in] PatternSize

Especifica o tamanho em bytes do padrão. Isso deve ser um múltiplo da granularidade do padrão.

[in] PatternGranularity

Especifica a granularidade do padrão. Para uma correspondência bem-sucedida, o padrão deve ocorrer um múltiplo desse valor após o local de início.

[out] MatchOffset

Recebe o local no espaço de endereço virtual do destino do padrão, se ele foi encontrado.

Valor de retorno

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

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Depois de examinar Comprimento bytes, o padrão não foi encontrado.

Observações

Esse método pesquisa a memória virtual do destino para a primeira ocorrência, sujeita à granularidade, do padrão totalmente contido no Length bytes da memória do destino começando no local Deslocamento.

PatternGranularity pode ser usado para garantir o alinhamento da correspondência em relação ao de Deslocamento. Por exemplo, um valor de 0x4 pode ser usado para exigir alinhamento a um DWORD. Um valor de 0x1 pode ser usado para permitir que o padrão comece em qualquer lugar.

Para obter opções adicionais, incluindo a capacidade de restringir a pesquisa à memória gravável, consulte SearchVirtual2.

Requisitos

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

Consulte também

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtual

SearchVirtual2

Compartilhar via