IDeviceSpecificProperty インターフェイス (devicetopology.h)

IDeviceSpecificProperty インターフェイスは、デバイス固有のハードウェア コントロールのコントロール値へのアクセスを提供します。 クライアントは、パラメーター refiid が REFIID IID_IDeviceSpecificPropertyに設定された IPart::Activate メソッドを呼び出して、パーツの IDeviceSpecificProperty インターフェイスへの参照を取得します。 IPart::Activate の呼び出しは、パーツが IDeviceSpecificProperty インターフェイスをサポートしている場合にのみ成功します。 このインターフェイスは、基になるハードウェア コントロールにデバイス固有のコントロール値があり、DeviceTopology API の他のインターフェイスでコントロールを適切に表すことができない場合にのみ、このインターフェイスをサポートします。

通常、デバイス固有のプロパティは、パーツの種類、パーツ のサブタイプ、パーツ名などの情報からプロパティ値の意味を推測できるクライアントにのみ役立ちます。 クライアントは、 IPart::GetPartType、IPart::GetSubType、および IPart::GetName メソッドを呼び出すことで、この情報 を取得 できます。

ほとんどの Windows オーディオ アダプター ドライバーは、Windows ドライバー モデル (WDM) をサポートし、カーネル ストリーミング (KS) プロパティを使用して、サブユニット (KS ノードと呼ばれる) のハードウェア制御パラメーターを表します。 IDeviceSpecificProperty インターフェイスは、サブタイプ GUID 値が KSNODETYPE_DEV_SPECIFIC であるサブユニットの KSPROPERTY_AUDIO_DEV_SPECIFIC プロパティに簡単にアクセスできます。 サブユニットのサブタイプ GUID を取得するには、 IPart::GetSubType メソッドを呼び出します。 KS プロパティと KS ノードの種類の詳細については、Windows DDK のドキュメントを参照してください。

継承

IDeviceSpecificProperty インターフェイスは、IUnknown インターフェイスから継承されます。 IDeviceSpecificProperty には、次の種類のメンバーもあります。

メソッド

IDeviceSpecificProperty インターフェイスには、これらのメソッドがあります。

IDeviceSpecificProperty::Get4BRange Get4BRange メソッドは、デバイス固有のプロパティ値の 4 バイト範囲を取得します。
IDeviceSpecificProperty::GetType GetType メソッドは、デバイス固有のプロパティ値のデータ型を取得します。
IDeviceSpecificProperty::GetValue GetValue メソッドは、デバイス固有のプロパティの現在の値を取得します。
IDeviceSpecificProperty::SetValue SetValue メソッドは、デバイス固有のプロパティの値を設定します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	devicetopology.h

関連項目

コア オーディオ インターフェイス

DeviceTopology API

IPart::Activate

IPart::GetName

IPart::GetPartType

IPart::GetSubType