指定された バッファーの BufferCallback 中に呼び出され、呼び出し元がバッファーを使用して完了するまで解放されないようにします。
構文
ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceBufferIncrementReference(
PROCESSTRACE_HANDLE TraceHandle,
const ETW_BUFFER_HEADER *Buffer
);
パラメーター
TraceHandle
この バッファー の元の処理セッション。
Buffer
参照するバッファー。 このバッファーは、 PETW_BUFFER_CALLBACK コールバックの呼び出しによって取得されている必要があります。
戻り値
Win32 エラー コード。 使用可能なコードには、ERROR_INVALID_PARAMETERとERROR_OUTOFMEMORYが含まれる場合があります。
備考
PETW_BUFFER_CALLBACK中に ProcessTraceBufferIncrementReference がバッファーで呼び出されない場合、 PETW_BUFFER_CALLBACK が戻った後、メモリ に アクセスできなくなります。
呼び出し元は、処理が完了したら、バッファーで ProcessTraceBufferDecrementReference を呼び出す役割を担います。 インクリメントされたすべてのバッファーに対してこれが行われるまで、ProcessTrace は戻りません。
ProcessTraceBufferIncrementReference は、 OpenTraceFromBufferStream によって開かれた処理セッションによって提供されるバッファーではサポートされていません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 11 2022 Update |
| サポートされている最小のサーバー | Windows Server 2022 |
| ターゲット プラットフォーム の | Windows |
| ヘッダー | evntrace.h |
| DLL | Windows 8.1およびWindows Server 2012 R2 のSechost.dll;Advapi32.dll Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows VistaとWindows XP |