Méthode IDebugDataSpaces2 ::SearchVirtual (dbgeng.h)

Article
02/26/2024

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 à rechercher pour le modèle. Une correspondance réussie nécessite que le modèle entier soit trouvé avant que les octets de longueur aient é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 un multiple 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 retournée

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

Code de retour	Description
S_OK	La méthode a réussi.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Après avoir examiné les octets de longueur , le modèle est introuvable.

Remarques

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

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