Fonction ProcessTraceBufferIncrementReference (evntrace.h)

Appelé pendant le BufferCallback sur la mémoire tampon fournie pour empêcher sa libération jusqu’à ce que l’appelant ait terminé avec elle.

Syntaxe

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceBufferIncrementReference(
  TRACEHANDLE             TraceHandle,
  const ETW_BUFFER_HEADER *Buffer
);

Paramètres

TraceHandle

Session de traitement d’où provient cette mémoire tampon .

Buffer

Mémoire tampon à référencer. Cette mémoire tampon doit avoir été obtenue par un appel au rappel PETW_BUFFER_CALLBACK .

Valeur retournée

Code d’erreur Win32. Les codes possibles peuvent inclure des ERROR_INVALID_PARAMETER et des ERROR_OUTOFMEMORY.

Remarques

Si ProcessTraceBufferIncrementReference n’est pas appelé sur une mémoire tampon pendant la PETW_BUFFER_CALLBACK la mémoire n’est plus accessible après le retour du PETW_BUFFER_CALLBACK .

L’appelant est responsable d’appeler ProcessTraceBufferDecrementReference sur la mémoire tampon une fois qu’il a terminé. ProcessTrace ne retourne pas tant que cela n’a pas été effectué pour chaque mémoire tampon incrémentée.

ProcessTraceBufferIncrementReference n’est pas pris en charge pour les mémoires tampons fournies par une session de traitement ouverte par OpenTraceFromBufferStream.

Configuration requise

Condition requise	Valeur
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