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 |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應