IDebugDataSpaces3::GetVirtualTranslationPhysicalOffsets-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetVirtualTranslationPhysicalOffsets Methode gibt die physischen Adressen der System pagingstrukturen auf verschiedenen Ebenen der Paginghierarchie zurück.

Syntax

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

Parameter

[in] Virtual

Gibt den Speicherort im virtuellen Adressbereich des Ziels an, der übersetzt werden soll.

[out, optional] Offsets

Empfängt die physischen Adressen für die System paging-Strukturen. Wenn sie auf NULL-festgelegt ist, werden diese Informationen nicht zurückgegeben.

[in] OffsetsSize

Gibt die Anzahl der Elemente an, die das Array Offsets Haltebereiche enthält. Dies ist die maximale Anzahl von Adressen, die zurückgegeben werden.

[out, optional] Levels

Empfängt die Anzahl der Ebenen in der Paginghierarchie für die angegebene Adresse. Wenn dies NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
HRESULT_FROM_NT(STATUS_NO_PAGEFILE)	Es wurde keine physische Seite gefunden, die die angegebene Adresse enthält.

Bemerkungen

Diese Methode ist nur im Kernelmodusdebugging verfügbar.

Das Übersetzen einer virtuellen Adresse in eine physische Adresse erfordert, dass Windows die Paginghierarchie heruntersetzt. Auf jeder Ebene liest sie Auslagerungsinformationen aus dem physischen Speicher. Diese Methode gibt die Offsets für diese physischen Seiten zurück. Die Anzahl der Ebenen in der Seitenhierarchie kann für unterschiedliche Adressen unterschiedlich sein.

Die Adresse auf der letzten Ebene der Hierarchie ist die physische Adresse, die der angegebenen virtuellen Adresse entspricht. Dies würde VirtualToPhysical- zurückgeben.

Ausführliche Informationen dazu, wie virtuelle Adressen in physische Adressen übersetzt werden, finden Sie unter Microsoft Windows Internals von David Solomon und Mark Russinovich.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über