IAMStats インターフェイス (control.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
インターフェイスは IAMStats 、フィルター グラフ マネージャーからパフォーマンス データを取得します。 フィルターでは、このインターフェイスを使用してパフォーマンス データを記録できます。
フィルター開発者: すべての Filter Graph Manager インターフェイスと同様に、フィルターはこのインターフェイスの参照カウントを保持しないか、循環参照カウントを発生させます。 詳細については、「 IBaseFilter::JoinFilterGraph」を参照してください。
継承
IAMStats インターフェイスは、IDispatch インターフェイスから継承されます。 IAMStats には、次の種類のメンバーもあります。
メソッド
IAMStats インターフェイスには、これらのメソッドがあります。
| IAMStats::AddValue AddValue メソッドは、新しい値を記録します。 |
| IAMStats::get_Count get_Count メソッドは、統計の数を取得します。 |
| IAMStats::GetIndex GetIndex メソッドは、名前付き統計のインデックスを取得するか、新しい統計を作成します。 |
| IAMStats::GetValueByIndex GetValueByIndex メソッドは、インデックスによって統計を取得します。 |
| IAMStats::GetValueByName GetValueByName メソッドは、名前で統計を取得します。 |
| IAMStats::Reset Reset メソッドは、すべての統計を 0 にリセットします。 |
注釈
各統計は、名前とインデックスによって定義されます。 GetIndex メソッドを使用して、名前からインデックスを検索します。 値は常に 倍精度 浮動小数点型です。 次の統計が定義済みです。
| 名前 | 説明 |
|---|---|
| RenderFile | IGraphBuilder::RenderFile を呼び出すたびにかかった時間を測定します。 |
| ConnectDirectInternal | 2 つのフィルターの接続にかかった時間を測定します。 |
| マッパー キャッシュのビルド | 登録済みフィルター ( Filter Mapper オブジェクトで使用) に関する情報をキャッシュするためにかかった時間を測定します。 |
| プロセス カテゴリ CategoryName | 特定のカテゴリのフィルターに関する情報をキャッシュするのにかかった時間を測定します。 CategoryName はフィルター カテゴリのフレンドリ名です。 ( 「フィルター カテゴリ」を参照してください)。 |
これらの統計のそれぞれについて、値は時間をミリ秒単位で表します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | control.h (Dshow.h を含む) |