IDebugDataSpaces2 ::GetVirtualTranslationPhysicalOffsets, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetVirtualTranslationPhysicalOffsets retourne les adresses physiques des structures de pagination système à différents niveaux de la hiérarchie de pagination.

Syntaxe

HRESULT GetVirtualTranslationPhysicalOffsets(
  [in]            ULONG64  Virtual,
  [out, optional] PULONG64 Offsets,
  [in]            ULONG    OffsetsSize,
  [out, optional] PULONG   Levels
);

Paramètres

[in] Virtual

Spécifie l’emplacement dans l’espace d’adressage virtuel de la cible à traduire.

[out, optional] Offsets

Reçoit les adresses physiques des structures de pagination système. S’il est défini sur NULL, ces informations ne sont pas retournées.

[in] OffsetsSize

Spécifie le nombre d’éléments que contient le tableau décalages. Il s’agit du nombre maximal d’adresses qui seront retournées.

[out, optional] Levels

Reçoit le nombre de niveaux dans la hiérarchie de pagination pour l’adresse spécifiée. Si cette valeur est NULL, ces informations ne sont pas retournées.

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_PAGEFILE)	Aucune page physique contenant l’adresse spécifiée n’est trouvée.

Remarques

Cette méthode n’est disponible que dans le débogage en mode noyau.

La traduction d’une adresse virtuelle en adresse physique nécessite que Windows descende la hiérarchie de pagination. À chaque niveau, il lit les informations de pagination à partir de la mémoire physique. Cette méthode retourne les décalages pour ces pages physiques. Le nombre de niveaux dans la hiérarchie de pagination peut être différent pour différentes adresses.

L’adresse au dernier niveau de la hiérarchie est l’adresse physique correspondant à l’adresse virtuelle spécifiée. C’est ce que VirtualToPhysical retournerait.

Pour plus d’informations sur la façon dont les adresses virtuelles sont traduites en adresses physiques, consultez Microsoft Windows Internals par David Salomon et Mark Russinovich.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Partager via