Funzione OpenTraceFromRealTimeLogger (evntrace.h)

Crea una sessione di elaborazione della traccia collegata a una sessione ETW attiva in tempo reale.

Sintassi

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

Parametri

LoggerName

Nome della sessione di traccia eventi in tempo reale o NULL se si elaborano dati da un file di log. Specificare un valore per questo membro se si chiama OpenTraceFromRealTimeLogger per utilizzare i dati da una sessione in tempo reale.

Quando si chiama OpenTraceFromRealTimeLogger, se LogFileHeader non ènull, LoggerName deve essere NULL.

È possibile utilizzare gli eventi in tempo reale solo se il controller di traccia ha impostato il membro LogFileMode di EVENT_TRACE_PROPERTIES per includere il flag di EVENT_TRACE_REAL_TIME_MODE.

Solo gli utenti con privilegi amministrativi, gli utenti nel gruppo Performance Log Users e le applicazioni in esecuzione come LocalSystem, LocalService, NetworkService possono utilizzare eventi in tempo reale. Per concedere a un utente limitato la possibilità di utilizzare gli eventi in tempo reale, aggiungerli al gruppo Performance Log Users o chiamare EventAccessControl.

Options

Opzioni di configurazione per questa sessione di elaborazione. Per altri dettagli, vedere ETW_OPEN_TRACE_OPTIONS.

LogFileHeader

Informazioni sull'intestazione per il file di log. Per altri dettagli, vedere TRACE_LOGFILE_HEADER.

Valore restituito

TRACEHANDLE utilizzato per identificare questa sessione di elaborazione. In genere passato a ProcessTrace per iniziare l'elaborazione e per CloseTrace alla fine dell'elaborazione.

Osservazioni

Dopo aver chiamato ProcessTrace sul TRACEHANDLE restituito, riceverà i buffer dalla sessione ETW mentre vengono scaricati e iniziano immediatamente a elaborarli e chiamando i callback specificati nella Options.

Fabbisogno