Compartilhar via

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

  • Artigo

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 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 Context for NULL, essas informações não serão retornadas.

[in] ContextSize

Especifica o tamanho, em bytes, do buffer especificado por 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 por 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.

Retornar valor

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

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

Comentários

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

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

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

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h, Ntddk.h)

Confira também

GetLastEventInformation

IDebugControl4