IControlManager

Windows イベント トレーシング (ETW) セッションを制御する Windows Performance Recorder マネージャーを表します。 クライアントは、IProfileCollection インターフェイスを使用してプロファイルのコレクションを渡します。また、マネージャーは、各プロファイルに記述されている ETW セッションまたはプロバイダーを開始、更新、取り消し、保存、停止、または照会できます。 クライアントは、IControlProgressHandler ハンドラーへのポインターを渡して、マネージャーが実行した操作に関する最新情報を受け取ることができます。

構文

{
  [propget, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([out, retval] IControlProgressHandler** ppControlProgressHandler);
  [propput, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([in] IControlProgressHandler* pControlProgressHandler);
  [id(2), helpstring("Start")] HRESULT Start
    ([in] IProfileCollection* pProfileCollection);
  [id(3), helpstring("Update")] HRESULT Update
    ([in] IProfileCollection* pProfileCollection);
  [id(4), helpstring("Cancel")] HRESULT Cancel
    ([in] IProfileCollection* pProfileCollection);
  [id(5), helpstring("Save")] HRESULT Save
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(6), helpstring("Stop")] HRESULT Stop
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(7), helpstring("QueryXML")] HRESULT QueryXML
    ([out] BSTR* pbstrResults,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [id(8), helpstring("Query")] HRESULT Query
    ([out] IProfileCollection** ppProfileCollection,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [propget, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([out, retval] ITraceMergeTextHandler** ppTraceMergeTextHandler);
  [propput, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([in] ITraceMergeTextHandler* pTraceMergeTextHandler);
  [propget, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([out, retval] BSTR* pbstrTemporaryTraceDirectory);
  [propput, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([in] BSTR bstrTemporaryTraceDirectory);
  [id(11), helpstring("GetProviderNameFromGuid")] HRESULT GetProviderNameFromGuid
    ([out] BSTR* bstrProviderIdStr,
    [in] REFGUID ProviderId);
  [id(12), helpstring("GetProviderGuidFromName")] HRESULT GetProviderGuidFromName
    ([out] GUID* ProviderId,
    [in] BSTR bstrProViderName);
};

関数

次の表では、このインターフェイスで提供される関数について説明します。

機能	説明
Start	記録を開始します。
アップデート	プロファイル コレクションを更新します。
キャンセル	データを保存せずに記録を停止します。
および	指定されたイベント トレース ログ (ETL) ファイルに、メモリ内の循環バッファーに記録された記録を保存します。
Stop	記録を停止し、指定されたイベント トレース ログ (ETL) ファイルにそれを保存します。
QueryXML	現在実行中のプロファイルの XML 形式と、プロファイルが適切に実行されているかどうかを示します。
クエリ	すべてのプロファイルのセッションとプロバイダーのプロパティを照会します。
propget	指定したプロパティを取得します。
propput	指定されたプロパティを設定します。
GetProviderNameFromGuid	指定された GUID のプロバイダー名を取得します。
GetProviderGuidFromName	指定された名前のプロバイダー GUID を取得します。

Properties

次の表では、このインターフェイスで取得または設定できるプロパティのパラメーターについて説明します。

プロパティ	パラメーター	説明
ControlProgressHandler	ppControlProgressHandler [out]	IControlProgressHandler インターフェイスのクライアント側の実装へのポインター。
ControlProgressHandler	pControlProgressHandler [in]	IControlProgressHandler インターフェイスのクライアント側の実装へのポインター。 E_POINTER は無効なポインターを示します。
TraceMergeTextHandler	ppTraceMergeTextHandler [out]	ITraceMergeTextHandler インターフェイスによって挿入されたトレース内のテキストおよびその他のマージ時情報へのポインター。
TraceMergeTextHandler	pTraceMergeTextHandler [in]	ITraceMergeTextHandler インターフェイスによって挿入されたトレース内のテキストおよびその他のマージ時情報へのポインター。 E_POINTER は無効なポインターを示します。
TemporaryTraceDirectory	pbstrTemporaryTraceDirectory [out]	マージ前のトレース ファイルが記録されるディレクトリのパスへのポインター。 既定値は %temp% フォルダーです。
TemporaryTraceDirectory [in]	bstrTemporaryTraceDirectory	マージ前のトレース ファイルが記録されるディレクトリのパス。

関連トピック

インターフェイス