ProcessTraceBufferIncrementReference 関数 (evntrace.h)

指定したバッファーで 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が含まれる場合があります。

備考

PETW_BUFFER_CALLBACK 中 ProcessTraceBufferIncrementReference がバッファーで呼び出されない場合、PETW_BUFFER_CALLBACK が戻った後、メモリにアクセスできなくなります。

呼び出し元は、バッファー 処理が完了したら、そのバッファーで ProcessTraceBufferDecrementReference を呼び出す役割を担います。 ProcessTrace は、インクリメントされたすべてのバッファーに対してこれが行われるまで戻りません。

ProcessTraceBufferIncrementReference は、OpenTraceFromBufferStreamによって開かれた処理セッションによって提供されるバッファー サポートされていません。

必要条件