Função de retorno de chamada ETWENABLECALLBACK (wdm.h)

A função EtwEnableCallback é uma função opcional de retorno de chamada fornecida pelo driver que é usada para receber notificações de habilitação ou desabilitação.

Sintaxe

ETWENABLECALLBACK Etwenablecallback;

VOID Etwenablecallback(
  [in]                LPCGUID SourceId,
                      ULONG ControlCode,
  [in]                UCHAR Level,
  [in]                ULONGLONG MatchAnyKeyword,
  [in]                ULONGLONG MatchAllKeyword,
  [in, optional]      PEVENT_FILTER_DESCRIPTOR FilterData,
  [in, out, optional] PVOID CallbackContext
)
{...}

Parâmetros

[in] SourceId

O GUID que identifica a sessão que habilitou o provedor.

ControlCode

[in] Level

O nível no qual o evento está habilitado. Esse parâmetro é um valor definido pelo provedor que especifica a detalhamento dos eventos que o provedor grava. O provedor deve gravar o evento se esse valor for menor ou igual ao valor de nível definido pelo evento.

Esse valor é passado no parâmetro Level da função EnableTraceEx ou no parâmetro EnableLevel da função EnableTrace.

[in] MatchAnyKeyword

A máscara de bits de palavras-chave que o provedor usa para determinar a categoria de eventos que ele grava.

Esse valor é passado no parâmetro MatchAnyKeyword da função EnableTraceEx ou o parâmetro EnableFlag da função EnableTrace. MatchAnyKeyword é um valor de 64 bits e é basicamente uma versão estendida do EnableFlagde 32 bits.

[in] MatchAllKeyword

Essa máscara de bits restringe ainda mais a categoria de eventos que o provedor grava.

Esse valor é passado no parâmetro MatchAllKeywords da função EnableTraceEx.

[in, optional] FilterData

Os dados definidos pelo provedor. Esse parâmetro é opcional. O provedor determina o layout dos dados e sua finalidade. Por exemplo, o provedor pode usar esses dados para filtrar adicionalmente os eventos que ele grava ou usá-los para executar alguns cálculos antes de gravar os eventos. Para obter informações detalhadas, consulte Descritor de Filtro de Evento.

[in, out, optional] CallbackContext

O contexto da função de retorno de chamada definida quando o provedor chamado EtwRegister se registrar. Esse parâmetro é opcional.

Valor de retorno

Nenhum

Observações

Use a função EtwRegister para especificar um ponteiro para a função etwEnableCallback .

Use o parâmetro FilterData da função de retorno de chamada para fornecer ao provedor habilidades sofisticadas de filtragem. A função etwEnableCallback não substitui as chamadas de função enable-status (EtwEventEnabled e EtwProviderEnabled). No entanto, ele serve como um suplemento para eles. No entanto, a menos que seu nível e palavras-chave estejam habilitados no momento, o evento não será gravado, independentemente do FilterData que a função de retorno de chamada fornece.

Os chamadores de etwEnableCallback devem estar em execução em IRQL = PASSIVE_LEVEL no contexto de um thread do sistema.

Requisitos

Consulte também

EnableTrace

EnableTraceEx

EtwEventEnabled

EtwProviderEnabled

EtwRegister

descritor de filtro de evento