IDebugDataSpaces4::GetOffsetInformation-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetOffsetInformation- Methode enthält allgemeine Informationen zu einer Adresse im Datenbereich eines Prozesses.

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 Welchen-Parameter 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 Bufferzurückgegebenen Daten bestimmt. Mögliche Werte sind:

DEBUG_OFFSINFO_VIRTUAL_SOURCE

Gibt die Quelle des virtuellen Speichers des Ziels bei Offset-zurück. Hier liest das Debuggermodul den Speicher aus. Space muss auf DEBUG_DATA_SPACE_VIRTUAL festgelegt werden. Ein ULONG wird an Bufferzurückgegeben. Dieser ULONG kann die in der folgenden Tabelle aufgeführten Werte annehmen.

Wert	Beschreibung
DEBUG_VSOURCE_INVALID	Der Offset- Offset ist im virtuellen Adressraum des Prozesses nicht verfügbar. Dies kann bedeuten, dass die Adresse ungültig ist oder der Speicher nicht verfügbar ist – z. B. enthält eine Absturzabbilddatei möglicherweise nicht den gesamten Speicher für den Prozess oder für den Kernel.
DEBUG_VSOURCE_DEBUGGEE	Der virtuelle Speicher am Offset Offset wird vom Ziel bereitgestellt.
DEBUG_VSOURCE_MAPPED_IMAGE	Das Debuggermodul liest den virtuellen Speicher des Ziels bei Offset Offset aus einer lokalen Bilddatei vor. Dies ist häufig der Fall in Minidumpdateien, bei denen die Modulimages nicht in der Dumpdatei enthalten sind und stattdessen vom Debuggermodul 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 empfängt. Der Typ der zurückgegebenen Daten hängt vom Wert Whichab. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Puffer-Puffers in Byte an.

[out, optional] InfoSize

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

Anforderungen

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

Freigeben über