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

Article
08/07/2023

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. Si elle est définie sur NULL, ces informations ne sont pas retournées.

[in] OffsetsSize

Spécifie le nombre d’éléments que le tableau Offsets contient. 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 la valeur est NULL, ces informations ne sont pas retournées.

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_PAGEFILE)	Aucune page physique contenant l’adresse spécifiée n’a pu être 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 selon les 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 de David Solomon et Mark Russinovich.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Share via