IAMDroppedFrames インターフェイス (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
IAMDroppedFrames インターフェイスは、削除されたフレームの数や配信された数など、ビデオ キャプチャ フィルターからパフォーマンス情報を取得します。 アプリケーションでは、このインターフェイスを使用して、実行時のキャプチャ パフォーマンスを決定できます。
継承
IAMDroppedFrames インターフェイスは、IUnknown インターフェイスから継承されます。 IAMDroppedFrames には、 次の種類のメンバーもあります。
メソッド
IAMDroppedFrames インターフェイスには、これらのメソッドがあります。
| IAMDroppedFrames::GetAverageFrameSize GetAverageFrameSize メソッドは、フィルターがキャプチャしたフレームの平均サイズを取得します。 |
| IAMDroppedFrames::GetDroppedInfo GetDroppedInfo メソッドは、削除されたフレーム番号の配列を取得します。 |
| IAMDroppedFrames::GetNumDropped GetNumDropped メソッドは、ストリーミングを開始してからフィルターが削除したフレームの合計数を取得します。 |
| IAMDroppedFrames::GetNumNotDropped GetNumNotDropped メソッドは、ストリーミングを開始してからフィルターが配信したフレームの合計数を取得します。 |
解説
このインターフェイスを公開するフィルターの中には 、GetDroppedInfo メソッドまたは GetAverageFrameSize メソッドが実装されていないものもあります。
Windows ドライバー モデル (WDM) デバイスの場合、 WDM ドライバー が PROPSETID_VIDCAP_DROPPEDFRAMES プロパティ セットをサポートしている場合、WDM ビデオ キャプチャ フィルターは自動的にこのインターフェイスを公開します。 詳細については、 Windows ドライバー キット (WDK) のドキュメントを参照してください。
ドロップされたフレームの数は、キャプチャ ドライバーによって報告されます。 この情報は特定のメディア サンプルと直接関連付けされないため、フレーム単位では正確ではありませんが、時間の経過と共に正確である必要があります。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |