Fonction OpenTraceFromBufferStream (evntrace.h)

Article
03/11/2023

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

Syntaxe

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE 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 terminée avec une mémoire tampon transmise à partir de ProcessTraceAddBufferToBufferStream, elle appelle ce rappel pour permettre toute libération ou autre nettoyage qui peut être nécessaire pour cette mémoire tampon.

BufferCompletionContext

Contexte fourni par l’utilisateur qui sera passé à BufferCompletionCallback.

Valeur retournée

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

Notes

L’appelant est censé fournir les données de la trace en appelant ProcessTraceAddBufferToBufferStream. Cela est généralement utilisé pour le traitement des traces 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 les mémoires tampons du réseau et les envoie 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 celui où les mémoires tampons ont été reçues de ProcessTrace (par exemple, la première mémoire tampon contient des informations d’en-tête et les mémoires tampons suivantes sont triées par heure de vidage). Le seul moyen pris en charge pour générer des mémoires tampons de cette façon est à partir de la session de traitement BufferCallback d’une autre session de traitement OpenTraceFromBufferStream, OpenTraceFromRealTimeLogger , OpenTraceFromRealTimeLoggerWithAllocationOptions.

Spécifications


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