ProcessTraceBufferIncrementReference 函式 （evntrace.h）

在提供的 Buffer 上 BufferCallback 期間呼叫，以防止釋放它，直到呼叫端完成為止。

語法

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

參數

TraceHandle

這個 Buffer 來自的處理會話。

Buffer

要參考的緩衝區。 呼叫 PETW_BUFFER_CALLBACK 回呼時，必須取得此緩衝區。

傳回值

Win32 錯誤碼。 可能的代碼可能包含ERROR_INVALID_PARAMETER和ERROR_OUTOFMEMORY。

言論

如果 ProcessTraceBufferIncrementReference 在 PETW_BUFFER_CALLBACK 期間未在 Buffer 上呼叫，則 PETW_BUFFER_CALLBACK 傳回之後將無法再存取記憶體。

呼叫端負責在緩衝區上呼叫 ProcessTraceBufferDecrementReference，一旦使用它。 ProcessTrace 在針對遞增的每個緩衝區完成此作業之前，才會傳回。

OpenTraceFromBufferStream所開啟之處理會話所提供的緩衝區不支援 ProcessTraceBufferIncrementReference。

要求

要求	價值
最低支援的用戶端	Windows 11 2022 Update
支援的最低伺服器	Windows Server 2022
目標平臺	窗戶
標頭	evntrace.h
連結庫	Advapi32.dll
DLL	Sechost.dll Windows 8.1 和 Windows Server 2012 R2;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.dll