プロパティ セット (DirectShow)

  • [アーティクル]

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

Microsoft DirectShow は、プロパティ セットを使用して、ハードウェアとそれに関連付けられているドライバーとフィルターによって提供される拡張サービスをサポートします。 ハードウェアベンダーとフィルター ベンダーは、新しい機能をプロパティとして定義し、それらをプロパティ セットに配置し、これらのプロパティ セットの仕様を公開できます。 アプリケーション開発者は、 IKsPropertySet インターフェイスのメソッドを使用して、ドライバーまたはフィルターが特定のプロパティ セットをサポートしているかどうかを判断し、それらのプロパティを取得または設定できます。

IKsPropertySet によって公開されるすべてのメソッドには、プロパティ セット (guidPropSet パラメーター) を識別する GUID と、プロパティ セット内のプロパティを識別する DWORD (dwPropID パラメーター) が必要です。 dwPropID パラメーターは、通常、列挙データ型のメンバーです。

個々のプロパティには、IKsPropertySet::Set メソッドと IKsPropertySet::Get メソッドの pPropData パラメーターで指定したデータを関連付けることができます。 これらのメソッドでは、プロパティ データは への voidポインターとして型指定されます。 データ型とデータの意味は、プロパティ セットの定義で指定されます。

次のセクションでは、DirectShow でサポートされているプロパティ セットに関する情報を提供します。