IDebugControl4::GetStoredEventInformation-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetStoredEventInformation- Methode ruft Informationen zu einem interessanten Ereignis ab, das im aktuellen Ziel verfügbar ist.

Syntax

HRESULT GetStoredEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  Context,
  [in]            ULONG  ContextSize,
  [out, optional] PULONG ContextUsed,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed
);

Parameter

[out] Type

Empfängt den Typ des gespeicherten Ereignisses. Eine Liste der möglichen Typen finden Sie unter DEBUG_EVENT_XXX.

[out] ProcessId

Empfängt die Prozess-ID des Prozesses, in dem das Ereignis aufgetreten ist. Wenn diese Informationen nicht verfügbar sind, werden stattdessen DEBUG_ANY_ID zurückgegeben.

[out] ThreadId

Empfängt die Thread-ID des Threads, in dem das letzte Ereignis aufgetreten ist. Wenn diese Informationen nicht verfügbar sind, werden stattdessen DEBUG_ANY_ID zurückgegeben.

[out, optional] Context

Empfängt den Threadkontext des gespeicherten Ereignisses. Der Typ des Threadkontexts ist die CONTEXT-Struktur für den effektiven Prozessor des Ziels zum Zeitpunkt des Ereignisses. Der Kontext puffer muss groß genug sein, um diese Struktur zu enthalten. Wenn Context-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] ContextSize

Gibt die Größe des Puffers in Bytes an, der Context- angibt.

[out, optional] ContextUsed

Empfängt die Größe in Bytes des Kontexts. Wenn ContextUsed-NULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] ExtraInformation

Empfängt zusätzliche Informationen über das Ereignis. Der Inhalt dieser zusätzlichen Informationen hängt vom Typ des Ereignisses ab. Wenn ExtraInformation-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] ExtraInformationSize

Gibt die Größe des Puffers in Bytes an, der ExtraInformation- angibt.

[out, optional] ExtraInformationUsed

Empfängt die Größe in Byte zusätzlicher Informationen. Wenn ExtraInformationUsedNULL-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.

Bemerkungen

Viele Ziele haben kein Interessantes.

Wenn es sich bei dem Ziel um eine Minidumpdatei im Benutzermodus handelt, speichert der Speicherabbilddateigenerator möglicherweise ein zusätzliches Ereignis. In der Regel ist dies das Ereignis, das den Generator zum Speichern der Speicherabbilddatei provoziert hat.

Weitere Informationen finden Sie im Thema Ereignisinformationen.

Anforderungen

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

Siehe auch

GetLastEventInformation-

IDebugControl4-

Freigeben über