Función de devolución de llamada ETWENABLECALLBACK (wdm.h)
La función EtwEnableCallback es una función de devolución de llamada proporcionada por el controlador opcional que se usa para recibir notificaciones de habilitación o deshabilitación.
Sintaxis
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
GUID que identifica la sesión que habilitó el proveedor.
ControlCode
[in] Level
Nivel en el que está habilitado el evento. Este parámetro es un valor definido por el proveedor que especifica el detalle de los eventos que escribe el proveedor. El proveedor debe escribir el evento si este valor es menor o igual que el valor de nivel que define el evento.
Este valor se pasa en el parámetro Level de la función EnableTraceEx o el parámetro EnableLevel de la función EnableTrace .
[in] MatchAnyKeyword
Máscara de bits de palabras clave que usa el proveedor para determinar la categoría de eventos que escribe.
Este valor se pasa en el parámetro MatchAnyKeyword de la función EnableTraceEx o el parámetro EnableFlag de la función EnableTrace . MatchAnyKeyword es un valor de 64 bits y es básicamente una versión extendida de EnableFlag de 32 bits.
[in] MatchAllKeyword
Esta máscara de bits restringe además la categoría de eventos que escribe el proveedor.
Este valor se pasa en el parámetro MatchAllKeywords de la función EnableTraceEx .
[in, optional] FilterData
Datos definidos por el proveedor. Este parámetro es opcional. El proveedor determina el diseño de los datos y su propósito. Por ejemplo, el proveedor puede usar estos datos para filtrar además los eventos que escribe o usarlos para realizar algunos cálculos antes de escribir los eventos. Para obtener información detallada, consulte Descriptor de filtro de eventos.
[in, out, optional] CallbackContext
Contexto de la función de devolución de llamada que se define cuando el proveedor llamado EtwRegister se registra a sí mismo. Este parámetro es opcional.
Valor devuelto
None
Observaciones
Use la función EtwRegister para especificar un puntero a la función EtwEnableCallback .
Use el parámetro FilterData de la función de devolución de llamada para proporcionar al proveedor capacidades sofisticadas de filtrado. La función EtwEnableCallback no reemplaza las llamadas de función enable-status (EtwEventEnabled y EtwProviderEnabled). Sin embargo, sirve como complemento para ellos. Sin embargo, a menos que el nivel y las palabras clave estén habilitados actualmente, el evento no se escribirá, independientemente de FilterData que proporcione la función de devolución de llamada.
Los autores de llamadas de EtwEnableCallback deben ejecutarse en IRQL = PASSIVE_LEVEL en el contexto de un subproceso del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h) |
| IRQL | PASSIVE_LEVEL |