IDebugDataSpaces4 ::SearchVirtual, méthode (dbgeng.h)

Article
02/06/2025

La méthode searchVirtual recherche dans la mémoire virtuelle de la cible un modèle d’octets spécifié.

Syntaxe

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

Paramètres

[in] Offset

Spécifie l’emplacement dans l’espace d’adressage virtuel de la cible pour commencer à rechercher le modèle.

[in] Length

Spécifie la distance à laquelle rechercher le modèle. Une correspondance réussie nécessite que l’intégralité du modèle soit trouvée avant longueur octets ont été examinés.

[in] Pattern

Spécifie le modèle à rechercher.

[in] PatternSize

Spécifie la taille en octets du modèle. Il doit s’agir d’un multiple de la granularité du modèle.

[in] PatternGranularity

Spécifie la granularité du modèle. Pour une correspondance réussie, le modèle doit se produire plusieurs de cette valeur après l’emplacement de début.

[out] MatchOffset

Reçoit l’emplacement dans l’espace d’adressage virtuel de la cible du modèle, s’il a été trouvé.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Après avoir examiné longueur octets, le modèle n’a pas été trouvé.

Remarques

Cette méthode recherche la mémoire virtuelle de la cible pour la première occurrence, sous réserve de granularité, du modèle entièrement contenu dans la Longueur octets de la mémoire de la cible à partir de l’emplacement Offset.

PatternGranularity peut être utilisé pour garantir l’alignement de la correspondance par rapport à Offset. Par exemple, une valeur de 0x4 peut être utilisée pour exiger l’alignement d’un DWORD. Une valeur de 0x1 peut être utilisée pour permettre au modèle de démarrer n’importe où.

Pour obtenir d’autres options, notamment la possibilité de limiter la recherche à la mémoire accessible en écriture, consultez SearchVirtual2.