estrutura EVENT_HEADER_EXTENDED_DATA_ITEM (evntcons.h)

  • Artigo

Define os dados estendidos que o ETW (Rastreamento de Eventos para Windows) coleta como parte dos dados do evento.

Sintaxe

typedef struct _EVENT_HEADER_EXTENDED_DATA_ITEM {
  USHORT    Reserved1;
  USHORT    ExtType;
  struct {
    USHORT Linkage : 1;
    USHORT Reserved2 : 15;
  };
  USHORT    DataSize;
  ULONGLONG DataPtr;
} EVENT_HEADER_EXTENDED_DATA_ITEM, *PEVENT_HEADER_EXTENDED_DATA_ITEM;

Membros

Reserved1

Reservado.

ExtType

Tipo de dados estendidos. Veja a seguir os valores possíveis.

Valor Significado
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID
 O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID que contém o identificador de atividade relacionado se você chamou EventWriteTransfer para gravar o evento.
EVENT_HEADER_EXT_TYPE_SID
 O membro DataPtr aponta para uma estrutura sid que contém o SID (identificador de segurança) do usuário que registrou o evento. O ETW inclui o SID se você definir o parâmetro EnableProperty de EnableTraceEx como EVENT_ENABLE_PROPERTY_SID.
EVENT_HEADER_EXT_TYPE_TS_ID
 O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_TS_ID que contém o identificador de sessão do terminal. O ETW inclui o identificador de sessão do terminal se você definir o parâmetro EnableProperty de EnableTraceEx como EVENT_ENABLE_PROPERTY_TS_ID.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_INSTANCE que contém o identificador de atividade se você chamou TraceEventInstance para gravar o evento.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_STACK_TRACE32 que contém a pilha de chamadas se o evento for capturado em um computador de 32 bits.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_STACK_TRACE64 que contém a pilha de chamadas se o evento for capturado em um computador de 64 bits.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 O membro DataPtr aponta para um item de cabeçalho estendido que contém informações de metadados de evento TraceLogging.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 O membro DataPtr aponta para um item de cabeçalho estendido que contém dados de características do provedor, por exemplo, características definidas por meio de EventSetInformation(EventProviderSetTraits) ou especificadas por meio de EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA.
EVENT_HEADER_EXT_TYPE_EVENT_KEY
 O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_EVENT_KEY que contém um identificador de evento exclusivo que é um escalar de 64 bits.

O EVENT_ENABLE_PROPERTY_EVENT_KEY EnableProperty precisa ser passado para a chamada EnableTrace para um determinado provedor habilitar esse recurso.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_PROCESS_START_KEY que contém um identificador de processo exclusivo (exclusivo na sessão de inicialização). Esse identificador é um escalar de 64 bits.

O EVENT_ENABLE_PROPERTY_PROCESS_START_KEY EnableProperty precisa ser passado para a chamada EnableTrace para um determinado provedor habilitar esse recurso.

Linkage

Reservado.

Reserved2

Reservado.

DataSize

Tamanho, em bytes, dos dados estendidos para os quais o DataPtr aponta.

DataPtr

Ponteiro para os dados estendidos. O membro ExtType determina o tipo de dados estendidos para os quais esse membro aponta.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho evntcons.h (inclua Evntcons.h)

Confira também

EVENT_RECORD