estrutura EVENT_HEADER_EXTENDED_DATA_ITEM (evntcons.h)

Define os dados estendidos coletados pelo ETW (Rastreamento de Eventos para Windows) 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

O tipo de dados estendidos. Os exemplos a seguir são alguns valores possíveis.

Valor	Significado
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 EnableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY precisa ser passado para a chamada EnableTrace para um determinado provedor habilitar esse recurso.
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_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_PMC_COUNTERS	O membro DataPtr aponta para uma estrutura EVENT_EXTENDED_ITEM_PMC_COUNTERS que contém os valores atuais do Contador pmc. Para habilitar esse recurso, os contadores PMC válidos para a CPU devem ser definidos por meio de TraceSetInformation, com valores de de origem de válidos encontrados chamando TraceQueryInformation com TraceProfileSourceListInfo.
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.
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 EventSetInformation(EventProviderSetTraits) ou especificadas por meio de EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA.
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID	O membro DataPtr aponta para uma estrutura de 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 de 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 para EVENT_ENABLE_PROPERTY_SID.
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 de 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_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 de terminal se você definir o parâmetro EnableProperty de EnableTraceEx para EVENT_ENABLE_PROPERTY_TS_ID.

Linkage

Reservado.

Reserved2

Reservado.

DataSize

Tamanho, em bytes, dos dados estendidos aos quais DataPtr aponta.

DataPtr

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
cabeçalho	evntcons.h (inclua Evntcons.h)

Consulte também

EVENT_RECORD