ProcessTraceBufferIncrementReference, fonction (evntrace.h)

Article
07/19/2024

Appelé pendant la BufferCallback sur la mémoire tampon fournie pour empêcher sa libération 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

La session de traitement à partir de laquelle cette 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 chargé d’appeler 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

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