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 habilitadas ou desabilitados.

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 no parâmetro EnableFlag da função EnableTrace . MatchAnyKeyword é um valor de 64 bits e é basicamente uma versão estendida do EnableFlag de 32 bits.

[in] MatchAllKeyword

Essa máscara de bits restringe adicionalmente 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 chamou EtwRegister para se registrar. Esse parâmetro é opcional.

Retornar valor

Nenhum

Comentários

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 de filtragem sofisticadas. 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

Confira também

EnableTrace

EnableTraceEx

EtwEventEnabled

EtwProviderEnabled

EtwRegister

Descritor de Filtro de Evento