フィルター基底クラスの概要

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

この記事では、Microsoft DirectShow 基本クラス ライブラリについて説明します。 このライブラリはフィルター開発者向けですが、アプリケーション ライターはヘルパー クラスとデバッグ ユーティリティの一部が役立つ場合があります。 ただし、DirectShow プログラミングでは基本クラス ライブラリは必要ありません。

次のセクションでは、ライブラリ内で最も重要な基底クラスをまとめます。

COM オブジェクト クラス

次のクラスは、COM オブジェクトの作成をサポートしています。

DirectShow クラスのほとんどは 、CBaseObject から派生します。 このクラスは、実行時に DLL 内のすべてのアクティブ オブジェクトの数を保持することでデバッグ支援を提供します。 デバッグ ビルドでは、オブジェクト数が 0 より大きい間にアンロードされた場合、DLL はアサートします。 これにより、参照カウントの問題によって引き起こされるリークを簡単に追跡できます。

COM インターフェイスをサポートするすべての基底クラスは、CBaseObject を継承する CUnknown から派生します。 CUnknown クラスは、参照カウント、QueryInterface、および aggregration をサポートしています。 詳細については、「 IUnknown を実装する方法」を参照してください。

クラスのフィルターとピン留め

次のクラスは、DirectShow フィルターとピン 留めオブジェクトの作成をサポートしています。

次のクラスは、より特殊な種類のフィルターを作成するのに役立ちます。

これらのクラスを使用するには、独自のクラスを派生させ、フィルターに固有の機能をサポートするコードを記述する必要があります。 基底クラスの特殊化が高いほど、派生クラスで記述する必要があるコードが少なくなります。

ヘルパー オブジェクト

次のクラスは、フィルターとピンで使用されるヘルパー オブジェクトを実装します。 これらのクラスのほとんどは、新しいクラスを派生させずに使用できます。