ProcessTraceBufferIncrementReference 関数 (evntrace.h)

指定された バッファーの 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 によって開かれた処理セッションによって提供されるバッファーではサポートされていません。

必要条件