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

Artigo
02/23/2024

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

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

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.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Depois de examinar Bytes de comprimento , o padrão não foi encontrado.

Comentários

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

PatternGranularity pode ser usado para garantir o alinhamento da correspondência em relação a Offset. 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.