estrutura ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)

  • Artigo

A estrutura ENABLE_TRACE_PARAMETERS_V1 contém informações usadas para habilitar um provedor por meio de EnableTraceEx2. Essa estrutura está obsoleta. Em vez disso , use ENABLE_TRACE_PARAMETERS .

Sintaxe

typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
  ULONG                    Version;
  ULONG                    EnableProperty;
  ULONG                    ControlFlags;
  GUID                     SourceId;
  PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;

Membros

Version

Defina como ENABLE_TRACE_PARAMETERS_VERSION (1).

EnableProperty

Informações opcionais que o ETW pode incluir ao gravar o evento. Os dados são gravados na seção de item de dados estendido do evento. Para incluir as informações opcionais, especifique um ou mais dos sinalizadores a seguir; caso contrário, defina como zero.

  • EVENT_ENABLE_PROPERTY_SID

    Inclua nos dados estendidos o SID (identificador de segurança) do usuário.

  • EVENT_ENABLE_PROPERTY_TS_ID

    Inclua nos dados estendidos o identificador de sessão do terminal.

  • EVENT_ENABLE_PROPERTY_STACK_TRACE

    Adicione um rastreamento de pilha de chamadas aos dados estendidos de eventos gravados usando EventWrite.

    Observação

    O ETW removerá o evento se o tamanho total do evento exceder 64K. Se o provedor estiver registrando eventos próximos ao máximo de 64K, é possível que a habilitação da captura de pilha faça com que o evento seja perdido.

    Se a pilha for maior que o número máximo de quadros (192), os quadros serão cortados da parte inferior da pilha.

    Para os consumidores, os eventos incluirão a EVENT_EXTENDED_ITEM_STACK_TRACE32 ou EVENT_EXTENDED_ITEM_STACK_TRACE64 item estendido. Observe que os consumidores de 32 bits podem receber rastreamentos de pilha de 64 bits de processos de 64 bits.

ControlFlags

Reservado. Defina como 0.

SourceId

Um GUID que identifica exclusivamente o chamador que está habilitando ou desabilitando o provedor. Se o provedor não implementar EnableCallback, o GUID não será usado.

EnableFilterDesc

Uma estrutura EVENT_FILTER_DESCRIPTOR que aponta para os dados de filtro. O provedor usa dados de filtro para impedir que eventos que correspondam aos critérios de filtro sejam gravados na sessão. O provedor determina o layout dos dados e como ele aplica o filtro aos dados do evento. Uma sessão pode passar apenas um filtro para o provedor.

Uma sessão pode chamar a função TdhEnumerateProviderFilters para determinar os filtros esquematizados que ela pode passar para o provedor.

Comentários

ENABLE_TRACE_PARAMETERS_V1 está obsoleto. A estrutura ENABLE_TRACE_PARAMETERS é uma estrutura versão 2 e substitui a estrutura ENABLE_TRACE_PARAMETERS_V1 .

Normalmente, em computadores de 64 bits, você não pode capturar a pilha de kernel em determinados contextos quando falhas de página não são permitidas. Para habilitar a movimentação da pilha de kernel em x64, defina o valor do DisablePagingExecutive Registro de Gerenciamento de Memória como 1. O DisablePagingExecutive valor do Registro está localizado sob a seguinte chave do Registro: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Isso só deve ser feito para fins de diagnóstico temporário porque aumenta o uso de memória do sistema.

Requisitos

   
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 evntrace.h

Confira também

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2