ProcessTraceBufferIncrementReference-Funktion (evntrace.h)

Wird während des BufferCallbacks 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, von 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 von 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 OpenTraceFromBufferStream geöffnet wird, nicht unterstützt.

Anforderungen