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 è diverso da 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 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 con restrizioni 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 a CloseTrace fino alla fine dell'elaborazione.

Osservazioni

Una volta chiamato ProcessTracesull'oggetto TRACEHANDLE restituito, questo riceverà i buffer dalla sessione ETW mentre vengono scaricati e iniziano immediatamente a elaborarli e chiamando i callback specificati nelle opzioni.

Fabbisogno