OpenTraceFromRealTimeLoggerWithAllocationOptions, fonction (evntrace.h)

Article
07/19/2024

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

Syntaxe

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLoggerWithAllocationOptions(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  ULONG_PTR                    AllocationSize,
  HANDLE                       MemoryPartitionHandle,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Paramètres

LoggerName

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

Lorsque vous appelez OpenTraceFromRealTimeLoggerWithAllocationOptions, si LogFileHeader n’est pasNULL, 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 LogFileMode membre de EVENT_TRACE_PROPERTIES pour inclure l’indicateur de EVENT_TRACE_REAL_TIME_MODE.

Seuls les utilisateurs disposant de privilèges d’administration, des utilisateurs du groupe Utilisateurs du journal des performances et des 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 des performances ou appelez EventAccessControl.

Options

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

AllocationSize

Taille, en octets, de la mémoire qui sera pré-allouée pour stocker les mémoires tampons ETW pendant le traitement. Une allocation plus importante réduit la nécessité d’appels individuels d’allocation/gratuits au coût d’une utilisation plus cohérente de la mémoire. Cela sera ajusté vers le haut à un minimum de l’espace tampon total de la session ETW sous-jacente Real-Time pour garantir que suffisamment est alloué pour le fonctionnement de base. Si 0, la taille par défaut est utilisée.

MemoryPartitionHandle

Handle de la partition de mémoire qui doit être utilisé pour les allocations de mémoire pour cette session de traitement. Si la valeur est NULL, la partition mémoire du processus est utilisée. Pour plus d’informations, consultez MemExtendedParameterPartitionHandle.

LogFileHeader

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

Valeur de retour

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

Remarques

Une fois ProcessTrace est appelée sur le TRACEHANDLE retourné, il reçoit les mémoires tampons de la session ETW lorsqu’elles sont vidées et commencent immédiatement à les traiter et appellent les rappels spécifiés dans les options. Cela est identique à OpenTraceFromRealTime, sauf qu’il autorise la personnalisation des allocations de mémoire pour la session de traitement.

Exigences

Exigence	Valeur
client minimum pris en charge	Mise à jour de Windows 11 2022
serveur minimum pris en charge	Windows Server 2022
plateforme cible	Windows
d’en-tête	evntrace.h
bibliothèque	Advapi32.dll
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

Partager via