ビデオ キャプチャ ミニドライバーのプロパティ セット
このセクションでは、Microsoft Windows XP、Windows 2000、および Windows 98/Me 以降のオペレーティング システムで WDM カーネル ストリーミング サービスを使用するビデオ キャプチャ ミニドライバーで使用できるビデオ キャプチャ固有のプロパティ セットについて説明します。
各プロパティの参照ページには、次の列見出しを含むテーブルが含まれています。
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
これらの見出しには次の意味があります。
Get
ターゲット KS オブジェクトは、KSPROPERTY_TYPE_GET プロパティ要求をサポートしていますか?
Set
ターゲット KS オブジェクトは、KSPROPERTY_TYPE_SET プロパティ要求をサポートしていますか?
移行先
ターゲットは、プロパティ要求が送信される KS オブジェクトです。 ビデオ キャプチャ プロパティのターゲットは、フィルターまたはピンです。 (プロパティ要求は、カーネル ハンドルによってターゲット オブジェクトを指定します)。
プロパティ記述子の種類
プロパティ記述子は、プロパティとそのプロパティに対して実行する操作を指定します。 記述子は常に KSPROPERTY 構造体で始まりますが、一部の種類の記述子には追加情報が含まれています。 たとえば、KSNODEPROPERTY 構造体は、KSPROPERTY 構造体で始まるが、ノード識別子も含むプロパティ記述子です。
プロパティ値の種類
プロパティには値があり、この値のタイプはプロパティによって異なります。 たとえば、2 つの状態 (オンまたはオフ) のいずれかにすることができるプロパティは、通常、BOOL 値を持っています。 0x0 から 0xFFFFFFFF までの整数値を想定できるプロパティには、ULONG 値が含まれる場合があります。 より複雑なプロパティには、配列または構造体である値が含まれる場合があります。
前述のプロパティ記述子とプロパティ値は、「KS プロパティ、イベント、およびメソッド」で説明されているインスタンス指定と操作データ バッファーのプロパティ固有バージョンです。
プロパティ要求では、次のいずれかのフラグを使用して、プロパティに対して実行される操作を指定します。
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
すべてのフィルター オブジェクトとピン オブジェクトは、プロパティに対する基本サポート操作をサポートします。 取得 操作と設定 操作をサポートするかどうかは、プロパティによって異なります。 フィルターまたはピン オブジェクトの継承機能を表すプロパティでは、取得操作のみが必要になる場合があります。 構成可能な設定を表すプロパティには設定操作のみが必要な場合がありますが、取得操作は現在の設定を読み取る場合にも役立ちます。 ビデオ キャプチャのプロパティで get、set、basic-support 操作を使用する方法の詳細については、「KS プロパティ」を参照してください。
すべてのプロパティの説明には、ビデオ キャプチャ ミニドライバーがプロパティの読み取りまたは書き込みをサポートする必要があるかどうかを示すテーブルが含まれています。 ビデオ キャプチャ ミニドライバーは、ミニドライバーでサポートされていないプロパティの取得または設定要求に応答して STATUS_NOT_SUPPORTED を返す必要があります。
次の一覧では、ビデオ キャプチャ ミニドライバーが使用するカーネル ストリーミング プロパティ セットについて説明します。
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
USB ビデオ クラス ドライバーでは、次のプロパティ セットを使用できます。
PROPSETID_VIDCAP_CAMERACONTROL