Metodo IDebugControl4::GetStoredEventInformation (dbgeng.h)

Articolo
02/23/2024

Il metodo GetStoredEventInformation recupera informazioni su un evento di interesse disponibile nella destinazione corrente.

Sintassi

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
);

Parametri

[out] Type

Riceve il tipo dell'evento archiviato. Per un elenco di tipi possibili, vedere DEBUG_EVENT_XXX.

[out] ProcessId

Riceve l'ID processo del processo in cui si è verificato l'evento. Se queste informazioni non sono disponibili, DEBUG_ANY_ID verrà restituita.

[out] ThreadId

Riceve l'ID thread del thread in cui si è verificato l'ultimo evento. Se queste informazioni non sono disponibili, DEBUG_ANY_ID verrà restituita.

[out, optional] Context

Riceve il contesto del thread dell'evento archiviato. Il tipo del contesto del thread è la struttura CONTEXT per il processore effettivo della destinazione al momento dell'evento. Il buffer di contesto deve essere abbastanza grande per contenere questa struttura. Se Context è NULL, queste informazioni non vengono restituite.

[in] ContextSize

Specifica le dimensioni, in byte, del buffer specificato da Context .

[out, optional] ContextUsed

Riceve le dimensioni in byte del contesto. Se ContextUsed è NULL, queste informazioni non vengono restituite.

[out, optional] ExtraInformation

Riceve informazioni aggiuntive sull'evento. Il contenuto di queste informazioni aggiuntive dipende dal tipo dell'evento. Se ExtraInformation è NULL, queste informazioni non vengono restituite.

[in] ExtraInformationSize

Specifica le dimensioni, in byte, del buffer specificato da ExtraInformation .

[out, optional] ExtraInformationUsed

Riceve le dimensioni in byte di informazioni aggiuntive. Se ExtraInformationUsed è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Molti obiettivi non hanno un evento di interesse.

Se la destinazione è un file minidump in modalità utente, il generatore di file dump può archiviare un evento aggiuntivo. In genere, questo è l'evento che ha provocato il generatore per salvare il file di dump.

Per altre informazioni, vedere l'argomento Informazioni sugli eventi.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include Dbgeng.h, Ntddk.h)

Vedi anche

GetLastEventInformation

IDebugControl4

Condividi tramite