Función de devolución de llamada WMIDPREQUEST (evntrace.h)

Artículo
08/23/2023

Un proveedor de eventos basado en RegisterTraceGuids ("clásico") implementa esta función para recibir solicitudes de notificación de habilitación o deshabilitación de controladores.

El tipo WMIDPREQUEST define un puntero a esta función de devolución de llamada. ControlCallback es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

WMIDPREQUEST Wmidprequest;

ULONG Wmidprequest(
  [in] WMIDPREQUESTCODE RequestCode,
       PVOID RequestContext,
       ULONG *BufferSize,
  [in] PVOID Buffer
)
{...}

Parámetros

[in] RequestCode

Código de solicitud. Este será uno de los siguientes valores.

Valor	Significado
WMI_ENABLE_EVENTS	Habilita el proveedor o cambia la configuración del proveedor.
WMI_DISABLE_EVENTS	Deshabilita el proveedor.

RequestContext

Contexto definido por el proveedor. El proveedor usa el parámetro RequestContext de
RegisterTraceGuids para especificar el contexto.

BufferSize

Reservado para uso interno.

[in] Buffer

Puntero a una estructura de WNODE_HEADER que contiene información sobre la sesión de seguimiento de eventos para la que el proveedor está habilitado o deshabilitado.

Valor devuelto

Debe devolver ERROR_SUCCESS si la devolución de llamada se realiza correctamente. Tenga en cuenta que ETW omite el valor devuelto de esta función, excepto cuando un controlador llama a EnableTrace para habilitar un proveedor y el proveedor aún no ha llamado a RegisterTraceGuids. Cuando esto ocurre, RegisterTraceGuids devolverá el valor devuelto de esta devolución de llamada si el registro se realizó correctamente.

Comentarios

Esta función se especifica mediante la función RegisterTraceGuids . Cuando el controlador llama a la función EnableTrace para habilitar, deshabilitar o cambiar las marcas o el nivel de habilitación, ETW llama a esta devolución de llamada. El proveedor habilita o deshabilita en función del valor RequestCode . Normalmente, el proveedor usa este valor para establecer una marca global para indicar su estado habilitado.

El proveedor define su interpretación de la habilitación o deshabilitación. Por lo general, si un proveedor está habilitado, genera eventos, pero mientras está deshabilitado, no lo hace.

ETW no pasa las marcas de habilitación y habilita el nivel que el controlador pasa a la función EnableTrace a esta devolución de llamada. Para recuperar esta información, llame a las funciones GetTraceEnableFlags y GetTraceEnableLevel , respectivamente.

También debe recuperar el identificador de sesión en esta devolución de llamada para futuras llamadas. Para recuperar el identificador de sesión, llame a la función GetTraceLoggerHandle .

La función de devolución de llamada no debe llamar a nada que pueda incurrir en LoadLibrary (más concretamente, todo lo que requiera un bloqueo del cargador).

Ejemplos

Para obtener un ejemplo de implementación de una función ControlCallback , consulte Escritura de eventos clásicos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	evntrace.h