Función de devolución de llamada ETWENABLECALLBACK (wdm.h)
La función EtwEnableCallback es una función de devolución de llamada opcional proporcionada por el controlador 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 ha habilitado 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 la 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 en 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 la 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, vea 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 llamó a EtwRegister para registrarse a sí mismo. Este parámetro es opcional.
Valor devuelto
Ninguno
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 de filtrado sofisticadas. La función EtwEnableCallback no reemplaza las llamadas a la 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 del FilterData que proporciona 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h) |
| irQL | PASSIVE_LEVEL |