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