ProcessTraceBufferIncrementReference, fonction (evntrace.h)

Appelé pendant le BufferCallback sur la mémoire tampon fournie pour l’empêcher d’être libéré jusqu’à ce que l’appelant soit terminé avec celui-ci.

Syntaxe

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

Paramètres

TraceHandle

Session de traitement à partir de laquelle cette mémoire tampon provient.

Buffer

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

Valeur de retour

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

Remarques

Si ProcessTraceBufferIncrementReference n’est pas appelé sur une mémoire tampon pendant l’PETW_BUFFER_CALLBACK , la mémoire n’est plus accessible une fois le PETW_BUFFER_CALLBACK retourné.

L’appelant est responsable de l’appel de ProcessTraceBufferDecrementReference sur la mémoire tampon une fois qu’ils sont terminés avec celui-ci. 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.

Exigences