Método IDebugControl4::GetStoredEventInformation (dbgeng.h)

Artigo
02/06/2025

O método GetStoredEventInformation recupera informações sobre um evento de interesse disponível no destino atual.

Sintaxe

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

Parâmetros

[out] Type

Recebe o tipo do evento armazenado. Para obter uma lista de tipos possíveis, consulte DEBUG_EVENT_XXX.

[out] ProcessId

Recebe a ID do processo no qual o evento ocorreu. Se essas informações não estiverem disponíveis, DEBUG_ANY_ID será retornado.

[out] ThreadId

Recebe a ID do thread no qual o último evento ocorreu. Se essas informações não estiverem disponíveis, DEBUG_ANY_ID será retornado.

[out, optional] Context

Recebe o de contexto de thread do evento armazenado. O tipo do contexto de thread é a estrutura CONTEXT para o processador efetivo do destino no momento do evento. O buffer de Contexto deve ser grande o suficiente para manter essa estrutura. Se de Contexto for NULL, essas informações não serão retornadas.

[in] ContextSize

Especifica o tamanho, em bytes, do buffer especificado Context.

[out, optional] ContextUsed

Recebe o tamanho em bytes do contexto. Se ContextUsed for NULL, essas informações não serão retornadas.

[out, optional] ExtraInformation

Recebe informações extras sobre o evento. O conteúdo dessas informações extras depende do tipo do evento. Se ExtraInformation for NULL, essas informações não serão retornadas.

[in] ExtraInformationSize

Especifica o tamanho, em bytes, do buffer especificado ExtraInformation.

[out, optional] ExtraInformationUsed

Recebe o tamanho em bytes de informações extras. Se ExtraInformationUsed for NULL, essas informações não serão retornadas.

Valor de retorno

Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Observações

Muitos destinos não têm um evento de interesse.

Se o destino for um arquivo de minidump no modo de usuário, o gerador de arquivos de despejo poderá armazenar um evento adicional. Normalmente, esse é o evento que provocou o gerador para salvar o arquivo de despejo.

Para obter mais informações, consulte o tópico de Informações do Evento.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h, Ntddk.h)

Consulte também

GetLastEventInformation

IDebugControl4

Partilhar via