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

Article
02/23/2024

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

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 l’examen des octets de longueur .

[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 examen des 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 la longueur des octets de la mémoire de la cible en commençant à 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 sur un DWORD. La valeur 0x1 peut être utilisée pour permettre au modèle de démarrer n’importe où.

Pour obtenir des options supplémentaires, notamment la possibilité de limiter la recherche à la mémoire accessible en écriture, consultez SearchVirtual2.