IDebugControl4::GetStoredEventInformation-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetStoredEventInformation-Methode ruft Informationen zu einem ereignis von Interesse 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 Kontextpuffer muss groß genug sein, um diese Struktur zu enthalten. Wenn ContextNULL ist, werden diese Informationen nicht zurückgegeben.

[in] ContextSize

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

[out, optional] ContextUsed

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

[out, optional] ExtraInformation

Empfängt zusätzliche Informationen zum Ereignis. Der Inhalt dieser zusätzlichen Informationen hängt vom Typ des Ereignisses ab. Wenn ExtraInformationNULL ist, werden diese Informationen nicht zurückgegeben.

[in] ExtraInformationSize

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

[out, optional] ExtraInformationUsed

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

Hinweise

Viele Ziele haben kein ereignis von interesse.

Wenn es sich bei dem Ziel um eine Minidumpdatei im Benutzermodus handelt, kann der Dumpdatei-Generator ein zusätzliches Ereignis speichern. In der Regel ist dies das Ereignis, das den Generator dazu bewegt hat, die Dumpdatei zu speichern.

Weitere Informationen finden Sie im Thema Ereignisinformationen.

Anforderungen

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

Weitere Informationen

GetLastEventInformation

IDebugControl4

Freigeben über