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