CTRPP

CTRPP ツールは、V2 プロバイダーのマニフェストを解析して検証するプリプロセッサです。 このツールは、 .rc プロバイダーのコンシューマーが必要とする文字列を含むリソースを生成し、カウンター データを提供するために使用するコードを含むヘッダーを生成 .h します。 プロバイダーのビルド中に CTRPP ツールを実行する必要があります。 このコードを自分で生成するのではなく、プロバイダーを開発するときに、生成されたコードを出発点として使用する必要があります。

ctrpp -o codeFile -rc rcFile [-legacy] [-MemoryRoutines] [-NotificationCallback] [-prefix prefix] [-ch symFile] [-backcompat] inputFile

引数

注釈

CTRPP ツールは、コード ファイル、リソース ファイルを.rc生成.hし、必要に応じてシンボル ファイルを.h生成します。

生成されたリソース ファイルの使用

CTRPP ツールは、プロバイダーのカウンターセットのコンシューマーが必要とするローカライズ可能な文字列を含むリソース ファイルを生成 .rc します。

文字列リソースは、次のように処理する必要があります。

• 開発者はプロバイダー マニフェスト (.man) ファイルを編集して、プロバイダーの属性を、プロバイダーの文字列リソースを含み、プロバイダー コンポーネントの一部としてインストールされるプロバイダー バイナリ (.DLL、.SYS、または.EXE) の名前に設定 applicationIdentity します。
• CTRPP ツールはプロバイダー マニフェストを読み取り、ファイルを .rc 生成します。
• RC (リソース コンパイラ) ツールは、CTRPP によって生成された.rcファイルのデータをコンパイルして、.resバイナリ リソースを含むファイルを生成します。 これを行うには、CTRPP で生成された.rcファイルを直接コンパイルするか、 ディレクティブを使用して CTRPP によって生成された.rcファイルを含む別.rcのファイルを#includeコンパイルします。
• リンカーは、RC によって生成された .res ファイルのデータをプロバイダー バイナリに埋め込みます。
• インストール時に、プロバイダー バイナリがユーザーのシステムにコピーされ、プロバイダー マニフェストが lodctr ツールを使用して登録されます。 lodctr ツールは、プロバイダー マニフェストの属性を完全なパスに変換 applicationIdentity し、レジストリ内のプロバイダー バイナリへの完全パスを記録します。
  • プロバイダー バイナリがマニフェストと同じディレクトリにある場合は、 を使用します lodctr.exe /m:"C:\full\manifest\path\manifest.man"。 lodctr は、指定されたマニフェスト パスとマニフェストの applicationIdentity 属性を組み合わせて、完全なパスを形成します。
  • それ以外の場合は、 lodctr.exe /m:"C:\full\manifest\path\manifest.man" "c:\full\binary\path"を指定します。 lodctr は、指定されたバイナリ パスとマニフェストの applicationIdentity 属性を組み合わせて、完全なパスを形成します。
  • 診断目的で、レジストリ キー HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\_V2Providers\{<ProviderGuid>}の値を確認することで、記録された完全パスをApplicationIdentity調べることができます。
  • バイナリがローカライズに MUI を使用している場合は、必ずバイナリと共に MUI ファイルをコピーしてください。
• カウンターセット収集中、コンシューマーはプロバイダー バイナリへの記録された完全パスを使用して、プロバイダー バイナリのリソースから必要な文字列を見つけて読み込みます。

生成されたコード ファイルをユーザー モード プロバイダーで使用する

CTRPP ツールは C/C++ コード ファイルを .h 生成します。 プロバイダー マニフェストの providerType 属性が に userMode設定されている場合、生成されたコード ファイルには、ユーザー モード プロバイダーのコーディングに役立つ次の定義が含まれます。

• プレフィックスCounterInitialize という名前のプロバイダー初期化関数。
• プレフィックスCounterCleanup という名前のプロバイダー クリーンアップ関数。
• プレフィックスCounterInitialize 関数によって開かれたプロバイダー ハンドルを格納するグローバル プロバイダー変数。 変数の名前は、マニフェスト内の symbol 要素の属性の provider 値です。 この変数は、プロバイダーのデータを制御するために PerfCreateInstance、、 PerfDeleteInstance、およびその他の API の呼び出しで使用する必要があります。
• カウンターセットごとに、 カウンターセットGUID を 持つグローバル カウンターセット GUID 変数。 変数の名前は、要素symbolの 属性のcounterSet値にサフィックス "GUID" を加えた値です (例: )。 MyCounterSetGUID この変数は、プロバイダーのデータを制御するために PerfCreateInstance、、 PerfDeleteInstance、およびその他の API の呼び出しで使用する必要があります。
• カウンターごとに、 カウンター の値を持つカウンター id マクロ。 マクロの名前は、要素symbolの属性のcounter値です。 このマクロは、プロバイダーのデータを設定するための PerfSetCounterRefValue、 PerfSetULongLongCounterValue、およびその他の API の呼び出しで使用する必要があります。

関数名では、 prefix はコマンド ライン パラメーターの値を -prefix 参照します。 パラメーターが-prefix使用されていない場合、関数には と という名前が付CounterCleanupけられますCounterInitialize。

カーネル モード プロバイダーで生成されたコード ファイルを使用する

CTRPP ツールは C/C++ コード ファイルを .h 生成します。 プロバイダー マニフェストの providerType 属性が に kernelMode設定されている場合、生成されたコード ファイルには、カーネル モード プロバイダーのカウンターセットのコーディングに役立つ次の定義が含まれます。

• プレフィックスRegisterCounterset という名前のカウンターセット初期化関数。 この関数は RegInfo 構造体を入力し、 PcwRegister を呼び出し、結果として得られるカウンターセット登録ハンドルをグローバル Counterset 変数に格納します。
• prefixUnregisterCounterset という名前のカウンターセット クリーンアップ関数。 この関数は、グローバル Counterset 変数のカウンターセット登録ハンドルで PcwUnregister を呼び出します。
• プレフィックスCreateCounterset という名前のインスタンス作成関数。 この関数は、PcwData 構造体の配列を入力し、グローバル Counterset 変数のカウンターセット登録ハンドルを使用して PcwCreateInstance を呼び出します。
• プレフィックスCloseCounterset という名前のインスタンス クリーンアップ関数。 この関数は 、PcwCloseInstance を呼び出します。
• カウンターセット コールバック関数から使用される プレフィックスAddCounterset という名前のインスタンス レポート関数。 この関数は 、PcwData 構造体の配列を入力し、 PcwAddInstance を呼び出します。
• Windows SDK 20H1 以降: 高度なシナリオで使用するための プレフィックスInitRegistrationInformationCounterset という名前の RegInfo 初期化関数。 この関数は 、RegInfo 構造体を入力します。 この関数は、生成された プレフィックスRegisterCounterset がニーズを満たさない場合 (RegInfo 構造体の値をカスタマイズする場合や、返されたハンドルを別の変数に格納する場合など) に使用できます。

関数名では、 prefix はコマンド ライン パラメーターの値を -prefix 参照します。 パラメーターが -prefix 使用されていない場合、関数にはプレフィックスはありません。

生成されたシンボル ファイルの使用

コマンド ラインで -ch パラメーターを指定すると、CTRPP ツールによってシンボル ファイルが .h 生成されます。 このファイルには、プロバイダー内の各カウンターセットの名前と GUID の C/C++ シンボルが含まれています。 シンボルは、 PerfLib V2 Consumer 関数を使用して、このカウンターセットのデータを使用するようにハードコーディングされたプログラムを作成するときに使用できます。

要件