OpenTraceFromBufferStream, fonction (evntrace.h)

Article
07/19/2024

Crée une session de traitement de suivi qui n’est pas directement attachée à un fichier ou à une session active.

Syntaxe

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromBufferStream(
  const ETW_OPEN_TRACE_OPTIONS    *Options,
  PETW_BUFFER_COMPLETION_CALLBACK BufferCompletionCallback,
  void                            *BufferCompletionContext
);

Paramètres

Options

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

BufferCompletionCallback

Lorsque la session de traitement est effectuée avec une mémoire tampon transmise à partir de ProcessTraceAddBufferToBufferStream, il appelle ce rappel pour autoriser toute libération ou tout autre nettoyage qui peut être nécessaire pour cette mémoire tampon.

BufferCompletionContext

Contexte fourni par l’utilisateur qui sera transmis au BufferCompletionCallback.

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

L’appelant doit fournir les données de la trace en appelant ProcessTraceAddBufferToBufferStream. Cela est généralement utilisé pour le traitement de trace en temps réel à distance : un système distant utilise OpenTraceFromRealTimeLogger et ProcessTrace avec un BufferCallback qui envoie des mémoires tampons sur le réseau à un système local, puis le système local appelle OpenTraceFromBufferStream et ProcessTrace, reçoit des mémoires tampons du réseau et les transmet au processeur de trace local à l’aide de ProcessTraceAddBufferToBufferStream.

Ce mode de traitement nécessite que les mémoires tampons soient fournies dans le même ordre que ceux reçus de ProcessTrace (par exemple, la première mémoire tampon contient des informations d’en-tête et les mémoires tampons suivantes sont classées par heure de vidage). Le seul moyen pris en charge de générer des mémoires tampons de cette façon provient du BufferCallback d’un autre OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions 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