IDebugDataSpaces4::GetOffsetInformation-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetOffsetInformation-Methode stellt allgemeine Informationen zu einer Adresse im Datenbereich eines Prozesses bereit.

Syntax

HRESULT GetOffsetInformation(
  [in]            ULONG   Space,
  [in]            ULONG   Which,
  [in]            ULONG64 Offset,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parameter

[in] Space

Gibt den Datenbereich an, auf den der Offset-Parameter angewendet wird. Die zulässigen Werte hängen vom Parameter Which ab.

[in] Which

Gibt an, welche Informationen zu den Daten abgefragt werden. Dadurch werden die möglichen Werte für Space und der Typ der in Buffer zurückgegebenen Daten bestimmt. Mögliche Werte:

DEBUG_OFFSINFO_VIRTUAL_SOURCE

Gibt die Quelle des virtuellen Arbeitsspeichers des Ziels bei Offset zurück. Hier liest die Debugger-Engine den Arbeitsspeicher aus. Leerzeichen muss auf DEBUG_DATA_SPACE_VIRTUAL festgelegt werden. Eine ULONG wird an Buffer zurückgegeben. Diese ULONG kann die in der folgenden Tabelle aufgeführten Werte übernehmen.

Wert	BESCHREIBUNG
DEBUG_VSOURCE_INVALID	Der Offsetoffset ist im virtuellen Adressraum des Prozesses nicht verfügbar. Dies kann bedeuten, dass die Adresse ungültig ist oder dass der Arbeitsspeicher nicht verfügbar ist. Beispielsweise enthält eine Absturzabbilddatei möglicherweise nicht den gesamten Arbeitsspeicher für den Prozess oder den Kernel.
DEBUG_VSOURCE_DEBUGGEE	Der virtuelle Arbeitsspeicher am Offsetoffset wird vom Ziel bereitgestellt.
DEBUG_VSOURCE_MAPPED_IMAGE	Die Debugger-Engine liest den virtuellen Arbeitsspeicher des Ziels am Offsetoffset aus einer lokalen Bilddatei. Dies ist häufig bei Minidumpdateien der Fall, wenn die Modulimages nicht in der Speicherabbilddatei enthalten sind und stattdessen von der Debugger-Engine geladen werden.

[in] Offset

Gibt den Offset im Datenbereich des Ziels an, für den die Informationen zurückgegeben werden.

[out, optional] Buffer

Gibt den Puffer an, der die Informationen empfangen soll. Der Typ der zurückgegebenen Daten hängt vom Wert von Which ab. Wenn BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Bytes an.

[out, optional] InfoSize

Empfängt die Größe der zurückgegebenen Informationen in Bytes. Wenn InfoSizeNULL 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.

Anforderungen

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

Freigeben über