IDebugDataSpaces3::GetVirtualTranslationPhysicalOffsets-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetVirtualTranslationPhysicalOffsets-Methode gibt die physischen Adressen der System paging-Strukturen 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 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 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.

Hinweise

Diese Methode ist nur im Kernelmodusdebuggen 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 Speicher 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, was VirtualToPhysical zurückgeben würde.

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
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Freigeben über