Compartir a través de

enumeración EVENT_INFO_CLASS (evntprov.h)

  • Artículo

El tipo de enumeración EVENT_INFO_CLASS se usa con la función EventSetInformation para especificar la operación de configuración que se va a realizar en un registro del proveedor de eventos ETW.

Syntax

typedef enum _EVENT_INFO_CLASS {
  EventProviderBinaryTrackInfo,
  EventProviderSetReserved1,
  EventProviderSetTraits,
  EventProviderUseDescriptorType,
  MaxEventInfo
} EVENT_INFO_CLASS;

Constantes

 
EventProviderBinaryTrackInfo
Agrega información de seguimiento binario de este proveedor a cada sesión que
recopila eventos de este proveedor de eventos. Los datos de seguimiento binario incluyen el
ruta de acceso completa al binario que contiene la devolución de llamada que se especificó cuando
registrar el proveedor de eventos. Esta información es útil si el binario
contiene mc.exegenerado
descodificación de recursos, pero no está registrado globalmente. Las herramientas de descodificación pueden usar
ruta de acceso en el seguimiento para buscar el binario y extraer los recursos de descodificación.

El búfer EventInformation no se usa con esta operación de configuración. The
El tiempo de ejecución de ETW usará automáticamente la ruta de acceso completa del módulo del autor de la llamada (el
ruta de acceso completa al archivo DLL o EXE que contiene la función de devolución de llamada especificada en .
llame a EventRegister). Para que esta operación sea útil, el mismo archivo DLL o EXE
el archivo debe contener los mc.exerecursos de descodificación generados.
EventProviderSetReserved1
No se usa.
EventProviderSetTraits
Establece rasgos para el proveedor, como el nombre del proveedor. Indica que ETW
debe reconocer el Type campo de
estructuras de EVENT_DATA_DESCRIPTOR usadas
con este proveedor. Requiere que el proveedor inicialice todos los campos del
EVENT_DATA_DESCRIPTOR estructuras, incluido el Reserved campo . (El
el proveedor normalmente debe establecer dataDescriptor.Reserved = 0, tal como lo hace .
EventDataDescCreate).

Tenga en cuenta que la estructura EVENT_DATA_DESCRIPTOR contiene un Type campo en un
sección de la estructura que anteriormente era el Reserved campo . Para evitar
problemas de compatibilidad con proveedores que dejan el campo Reservado sin inicializar,
ETW omitirá el Type campo (tratarlo como 0) a menos que el proveedor haya usado
EventProviderSetTraits o EventProviderUseDescriptorType en una llamada a
EventSetInformation.

El búfer EventInformation debe contener el
rasgos de proveedor que se van a usar para el
proveedor.
EventProviderUseDescriptorType
Especifica si ETW debe reconocer el Type campo de
estructuras de EVENT_DATA_DESCRIPTOR usadas
con este proveedor. Si TRUEes , requiere que el proveedor inicialice todos los campos de .
las estructuras de EVENT_DATA_DESCRIPTOR , incluido el Reserved campo . (El
el proveedor normalmente debe establecer dataDescriptor.Reserved = 0, tal como lo hace .
EventDataDescCreate).

Tenga en cuenta que la estructura EVENT_DATA_DESCRIPTOR contiene un Type campo en un
sección de la estructura que anteriormente era el Reserved campo . Para evitar
problemas de compatibilidad con proveedores que dejan el campo Reservado sin inicializar,
ETW omitirá el Type campo (tratarlo como 0) a menos que el proveedor haya usado
EventProviderSetTraits o EventProviderUseDescriptorType en una llamada a
EventSetInformation.

El búfer EventInformation debe contener un valor BOOLEAN (1 byte, value)
FALSE o TRUE).
MaxEventInfo
El primer código de operación no válido. Este valor puede cambiar en versiones posteriores
del SDK de Windows.

Requisitos

   
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado evntprov.h

Consulte también

EventSetInformation

Rasgos del proveedor