estrutura ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)
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 |