IDebugDataSpaces4::GetVirtualTranslationPhysicalOffsets-Methode (dbgeng.h)

Artikel
02/23/2024

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 zu übersetzenden virtuellen Adressraum des Ziels an.

[out, optional] Offsets

Empfängt die physischen Adressen für die Systempa pagingstrukturen. Wenn sie auf NULL festgelegt ist, werden diese Informationen nicht zurückgegeben.

[in] OffsetsSize

Gibt die Anzahl der Elemente an, die das Array Offsets 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 konnte keine physische Seite gefunden werden, die die angegebene Adresse enthält.

Hinweise

Diese Methode ist nur beim Debuggen im Kernelmodus verfügbar.

Um eine virtuelle Adresse in eine physische Adresse zu übersetzen, muss Windows die Paginghierarchie heruntergehen. Auf jeder Ebene werden Paginginformationen aus dem physischen Arbeitsspeicher gelesen. Diese Methode gibt die Offsets für diese physischen Seiten zurück. Die Anzahl der Ebenen in der Paginghierarchie kann für verschiedene Adressen unterschiedlich sein.

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

Ausführliche Informationen zur Übersetzung virtueller Adressen in physische Adressen finden Sie unter Microsoft Windows Internals by David Solomon und Mark Russinovich.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)

Freigeben über