ProcessTraceBufferIncrementReference-Funktion (evntrace.h)

Artikel
07/19/2024

Wird während des BufferCallback- für den bereitgestellten Puffer aufgerufen, um zu verhindern, dass er freigegeben wird, bis der Aufrufer damit fertig ist.

Syntax

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

Parameter

TraceHandle

Die Verarbeitungssitzung, aus der dieser Puffer stammt.

Buffer

Der zu referenzierende Puffer. Dieser Puffer muss durch einen Aufruf des PETW_BUFFER_CALLBACK Rückrufs abgerufen worden sein.

Rückgabewert

Win32-Fehlercode. Mögliche Codes können ERROR_INVALID_PARAMETER und ERROR_OUTOFMEMORY enthalten.

Bemerkungen

Wenn ProcessTraceBufferIncrementReference- während der PETW_BUFFER_CALLBACK nicht für einen Puffer aufgerufen wird, ist der Speicher nach dem Zurückgeben der PETW_BUFFER_CALLBACK nicht mehr verfügbar.

Der Aufrufer ist für das Aufrufen ProcessTraceBufferDecrementReference- für den Puffer verantwortlich, sobald sie damit fertig sind. ProcessTrace- wird erst zurückgegeben, wenn dies für jeden Puffer erfolgt ist, der erhöht wurde.

ProcessTraceBufferIncrementReference wird für Puffer, die von einer Verarbeitungssitzung bereitgestellt werden, die von OpenTraceFromBufferStreamgeöffnet wird, nicht unterstützt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11 2022 Update
mindestens unterstützte Server-	Windows Server 2022
Zielplattform-	Fenster
Header-	evntrace.h
Library	Advapi32.dll
DLL-	Sechost.dll unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP

Freigeben über