Partager via


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

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)