PETW_BUFFER_CALLBACK fonction de rappel (evntrace.h)

Article
08/23/2023

Définition de fonction pour le BufferCallback qui sera appelé par ProcessTrace.

Syntaxe

PETW_BUFFER_CALLBACK PetwBufferCallback;

BOOL PetwBufferCallback(
  const ETW_BUFFER_HEADER *Buffer,
  ULONG BufferSize,
  const ETW_BUFFER_CALLBACK_INFORMATION *ConsumerInfo,
  void *CallbackContext
)
{...}

Paramètres

Buffer

Pointeur vers les données de mémoire tampon brutes, qui commencent par un struct ETW_BUFFER_HEADER et sont suivis de données d’événement.

Par défaut, cette mémoire tampon n’est disponible que jusqu’au retour du rappel. Pour utiliser la mémoire tampon après le retour du rappel, appelez ProcessTraceBufferIncrementReference. La mémoire tampon reste disponible jusqu’à ce que vous appeliez ProcessTraceBufferDecrementReference dessus.

ProcessTrace ne retourne pas tant que toutes ces références buffer n’ont pas été décrémentées.

BufferSize

Taille de la mémoire tampon fournie.

ConsumerInfo

Contient des informations sur l’état actuel de la session de traitement.

CallbackContext

Contexte fourni par l’utilisateur à partir de ETW_OPEN_TRACE_OPTIONS. BufferCallbackContext.

Valeur retournée

Si la valeur est TRUE, le traitement se poursuit. Si la valeur est FALSE, le traitement des traces s’arrête et ProcessTrace retourne.

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

Partager via