estrutura EVENT_FILTER_HEADER (evntprov.h)

  • Artigo

Define os dados de cabeçalho que devem preceder os dados de filtro definidos no manifesto de instrumentação.

Sintaxe

typedef struct _EVENT_FILTER_HEADER {
  USHORT    Id;
  UCHAR     Version;
  UCHAR     Reserved[5];
  ULONGLONG InstanceId;
  ULONG     Size;
  ULONG     NextOffset;
} EVENT_FILTER_HEADER, *PEVENT_FILTER_HEADER;

Membros

Id

O identificador que identifica o filtro no manifesto de um filtro esquematizado. O atributo value do elemento filter contém o identificador.

Version

O número de versão do filtro para um filtro esquematizado. O atributo de versão do elemento de filtro contém o número de versão.

Reserved[5]

Reservado

InstanceId

Um identificador que identifica a sessão que passou o filtro. ETW define esse valor; a sessão deve definir esse membro como zero.

Os provedores usam esse valor para definir o parâmetro Filter de EventWriteEx para impedir que o evento seja gravado na sessão se os dados do evento não corresponderem aos critérios de filtro (o provedor determina a semântica de como os dados de filtro são usados para determinar se o evento é gravado na sessão).

Size

O tamanho, em bytes, desse cabeçalho e os dados de filtro que são acrescentados ao final desse cabeçalho.

NextOffset

O deslocamento do início desse objeto de filtro para o próximo objeto de filtro. O valor será zero se não houver mais blocos de filtro. ETW define esse valor; a sessão deve definir esse membro como zero.

Comentários

Os dados de filtro que você passa para o provedor também incluem um cabeçalho. O seguinte mostra um exemplo de como você definiria um filtro que continha três inteiros:

struct _MY_FILTER {
    EVENT_FILTER_HEADER FilterHeader;
    ULONG Int1;
    ULONG Int2;
    ULONG Int3;
} MY_FILTER, *MY_FILTER;

MY_FILTER FilterData;

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho evntprov.h

Confira também

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTrace

EnableTraceEx

EnableTraceEx2