ITraceDataProvider

トレースセッションで有効にするトレースプロバイダーを指定します。

特定のプロバイダーの表示名または GUID のみを取得したい場合や、そのプロバイダーとして登録されているプロセスの一覧のみを取得したい場合は、CoCreateInstance 関数を呼び出し、クラス識別子として __uuidof(TraceDataProvider) を、インターフェイス識別子として __uuidof(ITraceDataProvider) を渡すことで、このインターフェイスを取得できます。この目的でスクリプトからオブジェクトを作成するには、Pla.TraceDataProvider プログラム識別子を使用します。

インターフェイスを ITraceDataProviderCollection コレクションに追加する場合は、CoCreateInstance 関数を使用しないでください。

プロバイダーの表示名を取得または設定します。(Get)

プロバイダーの表示名を取得または設定します。(Put)

プロバイダーの GUID を取得または設定します。(Get)

プロバイダーの GUID を取得または設定します。(Put)

プロバイダーを有効にするために使用する情報のレベルを取得します。

ppLevel パラメーターは、イベントが生成する情報のレベルを指定するプロバイダー定義の値です。たとえば、この値を使用して、プロバイダーに生成させたいイベントの重大度レベル(情報、警告、エラー)を示すことができます。

レベル値の取得または設定には IValueMap インターフェイスを使用します。IValueMap::Value プロパティにはレベル値が格納されます。

また、IValueMap::Add メソッドを使用して 1 つ以上のレベル値を追加することもできます。IValueMapItem インターフェイスを使用する必要があるのは、レベルに名前を付けたい場合、またはレベルを追加・削除せずに有効化・無効化したい場合のみです。有効にできるレベルは 1 つだけです。

IValueMapItem::Key プロパティにはレベルの文字列表現(例: Information)が格納されます。IValueMapItem::Value プロパティにはレベル値が格納されます。IValueMapItem::Enabled プロパティは、レベルが有効かどうかを示します。

IValueMap::Value を使用してレベルを設定し、値マップコレクションに 1 つ以上の項目が含まれている場合、PLA はコレクション内で一致する値を検索し、それを有効にして他を無効にします。値が一覧に存在しない場合、PLA はそのレベルを追加します(項目には名前が付きません)。

プロバイダーに書き込ませたいイベントのカテゴリを決定するキーワードの一覧を取得します。

キーワードは、プロバイダーに書き込ませたいイベントのカテゴリを決定します。イベントのキーワードビットのいずれかが、この KeywordsAny マスクに設定されたビットのいずれかと一致する場合、プロバイダーはそのイベントを書き込みます。

プロバイダーが提供するすべてのイベントを含めるには、このプロパティを 0 に設定します。特定のイベントのみを含めるには、このキーワードマスクをそれらの特定のイベントに設定します。たとえば、プロバイダーが初期化およびクリーンアップルーチン用のイベント(ビット 0)、ファイル操作用のイベント(ビット 1)、計算操作用のイベント(ビット 2)を定義している場合、このマスクを 5(ビット 0 と 2 を設定)に設定することで、これらのイベントのうち 2 つのみ、つまり初期化・クリーンアップイベントと計算イベントを受け取るように選択できます。

プロバイダーに書き込ませたいイベントのカテゴリをさらに制限するには、ITraceDataProvider::KeywordsAll プロパティも設定します。

プロバイダーがより複雑なイベントキーワードを定義している場合(たとえば、読み取り用にビット 0、ローカルアクセス用にビット 1 を設定するイベントと、読み取り用にビット 0、リモートアクセス用にビット 2 を設定する 2 つ目のイベントを定義している場合)、このマスクを 1 に設定してすべての読み取りイベントを受け取ることも、このマスクを 1 に、KeywordsAll マスクを 3 に設定してローカル読み取りのみを受け取ることもできます。

イベントのキーワードが 0 の場合、プロバイダーはこのマスクや KeywordsAll マスクに関係なく、そのイベントをセッションに書き込みます。

Windows Vista より前のオペレーティングシステム向けに書かれたプロバイダーの場合、キーワード値は有効化フラグにマッピングされます。

キーワード値の取得または設定には IValueMap インターフェイスを使用します。IValueMap::Value プロパティを使用してキーワード値(マップ内のすべての項目を OR 演算子で結合した値)を取得することも、マップ内の各項目を列挙して個々のキーワード値を取得することもできます。

同様に、キーワード値を設定する場合は、IValueMap::Value プロパティを呼び出してキーワード値を設定するか、IValueMap::Add メソッドを呼び出して個々のキーワード値を追加します。

IValueMap::Value を使用してキーワードを設定し、値マップに 1 つ以上の項目が含まれている場合、PLA はコレクション内で一致する値を検索し、それらを有効にして他を無効にします。値が一覧に存在しない場合、PLA はそのキーワードを追加します(項目には名前が付きません)。

IValueMapItem::Key プロパティにはキーワードの文字列表現が格納されます。IValueMapItem::Value プロパティにはキーワード値が格納されます。IValueMapItem::Enabled プロパティは、キーワードが有効かどうかを示します。IValueMapItem インターフェイスを使用する必要があるのは、キーワードに名前を付けたい場合、またはキーワードを追加・削除せずに有効化・無効化したい場合のみです。

プロバイダーに書き込ませたいイベントのカテゴリを制限するキーワードの一覧を取得します。

イベントのキーワードビットのいずれかが KeywordsAny プロパティに設定されたビットのいずれかと一致する場合、プロバイダーはそのイベントを書き込みます。 KeywordsAll プロパティで指定されたキーワードは、プロバイダーに書き込ませたいイベントのカテゴリをさらに制限します。イベントのキーワードが KeywordsAny の条件を満たす場合、プロバイダーは KeywordsAll マスク内のすべてのビットがイベントのキーワードに存在する場合にのみ、そのイベントを書き込みます。KeywordsAny が 0 の場合、KeywordsAll マスクは使用されません。

KeywordsAll と KeywordsAny の条件がどのように関連するかについて詳しくは、KeywordsAny の「解説」セクションを参照してください。

キーワード値の取得または設定には IValueMap インターフェイスを使用します。IValueMap::Value プロパティを使用してキーワード値(マップ内のすべての項目を OR 演算子で結合した値)を取得することも、マップ内の各項目を列挙して個々のキーワード値を取得することもできます。

同様に、キーワード値を設定する場合は、IValueMap::Value プロパティを呼び出してキーワード値を設定するか、IValueMap::Add メソッドを呼び出して個々のキーワード値を追加します。

IValueMap::Value を使用してキーワードを設定し、値マップに 1 つ以上の項目が含まれている場合、PLA はコレクション内で一致する値を検索し、それらを有効にして他を無効にします。値が一覧に存在しない場合、PLA はそのキーワードを追加します(項目には名前が付きません)。

IValueMapItem::Key プロパティにはキーワードの文字列表現が格納されます。IValueMapItem::Value プロパティにはキーワード値が格納されます。IValueMapItem::Enabled プロパティは、キーワードが有効かどうかを示します。IValueMapItem インターフェイスを使用する必要があるのは、キーワードに名前を付けたい場合、またはキーワードを追加・削除せずに有効化・無効化したい場合のみです。

Event Tracing for Windows (ETW) がイベントに含める拡張データ項目の一覧を取得します。

このプロパティを使用して、イベントとともに次のデータ項目を要求します。

拡張データ項目の取得または指定には IValueMap インターフェイスを使用します。IValueMap::Value プロパティには OR 演算子で結合された項目が格納されます。IValueMapItem::Key プロパティには拡張データ項目の文字列表現が格納されます。IValueMapItem::Value プロパティには拡張データ項目の値が格納されます。

フィルターデータをプロバイダーの有効化に使用するかどうかを決定する値を取得または設定します。(Get)

フィルターデータをプロバイダーの有効化に使用するかどうかを決定する値を取得または設定します。(Put)

プロバイダー定義のフィルタータイプを取得または設定します。(Get)

プロバイダー定義のフィルタータイプを取得または設定します。(Put)

フィルタリングの目的でトレースデータプロバイダーに送信される任意のデータを取得または設定します。(Get)

フィルタリングの目的でトレースデータプロバイダーに送信される任意のデータを取得または設定します。(Put)

登録済みプロバイダーに関する詳細を取得します。

成功した場合は S_OK を返します。

カーネルプロバイダーを指定するには、bstrName パラメーターを "Windows Kernel Trace" に設定します。

コンテキストロガーを指定するには、bstrName を "Circular Kernel Context Logger" に設定します。コンテキストロガーは、コンピューターの現在の状態のスナップショットを提供します。ロガーは(ファイルではなく)メモリ内の 100 メガバイトの循環ログに書き込みます。その内容をコンシューマーに公開するには、IDataCollectorSet::Commit メソッドを呼び出してセッションをフラッシュします。

プロバイダーに関する詳細をこのインスタンスにマージします。

成功した場合は S_OK を返します。

プロバイダーのインターフェイス、またはそのプロバイダーを含むコレクションを指定できます。コレクションを指定した場合、このメソッドは一致するプロバイダーを検索します。

トレースデータプロバイダーのセキュリティ情報を設定します。

成功した場合は S_OK を返します。

トレースデータプロバイダーのセキュリティ情報を取得します。

成功した場合は S_OK を返します。

Event Tracing for Windows (ETW) プロバイダーとして登録されているプロセスの一覧を取得します。

成功した場合は S_OK を返します。