OpenTraceFromRealTimeLogger, fonction (evntrace.h)

Article
02/26/2024

Crée une session de traitement des traces attachée à une session ETW active en temps réel.

Syntaxe

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Paramètres

LoggerName

Nom de la session de suivi d’événements en temps réel, ou NULL si les données sont traitées à partir d’un fichier journal. Spécifiez une valeur pour ce membre si vous appelez OpenTraceFromRealTimeLogger pour consommer des données à partir d’une session en temps réel.

Lors de l’appel d’OpenTraceFromRealTimeLogger, si LogFileHeader n’a pas la valeur NULL , LoggerName doit être NULL.

Vous ne pouvez consommer des événements en temps réel que si le contrôleur de trace a défini le membre LogFileMode de EVENT_TRACE_PROPERTIES pour inclure l’indicateur EVENT_TRACE_REAL_TIME_MODE .

Seuls les utilisateurs disposant de privilèges d’administration, les utilisateurs du groupe Utilisateurs du journal de performances et les applications s’exécutant en tant que LocalSystem, LocalService, NetworkService peuvent consommer des événements en temps réel. Pour accorder à un utilisateur restreint la possibilité de consommer des événements en temps réel, ajoutez-les au groupe Utilisateurs du journal de performances ou appelez EventAccessControl.

Options

Options de configuration pour cette session de traitement. Pour plus d’informations, consultez ETW_OPEN_TRACE_OPTIONS .

LogFileHeader

Informations d’en-tête pour le fichier journal. Pour plus d’informations, consultez TRACE_LOGFILE_HEADER .

Valeur retournée

TRACEHANDLE utilisé pour identifier cette session de traitement. Généralement passé à ProcessTrace pour commencer le traitement et à CloseTrace pour terminer le traitement.

Remarques

Une fois que ProcessTrace est appelé sur le TRACEHANDLE retourné, celui-ci reçoit les mémoires tampons de la session ETW à mesure qu’ils sont vidés et commence immédiatement à les traiter et à appeler les rappels spécifiés dans les Options.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	evntrace.h
Bibliothèque	Sechost.lib sur Windows 8.1 et Windows Server 2012 R2 ; Advapi32.lib sur Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista et Windows XP
DLL	Sechost.dll sur Windows 8.1 et Windows Server 2012 R2 ; Advapi32.dll sur Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista et Windows XP

Share via