IPart::GetSubType メソッド (devicetopology.h)

GetSubType メソッドは、このパーツのパーツ サブタイプを取得します。

構文

HRESULT GetSubType(
  [out] GUID *pSubType
);

パラメーター

[out] pSubType

メソッドがこの部分のサブタイプ GUID を書き込む GUID 変数へのポインター。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

解説

このメソッドは通常、ヘッダー ファイル Ksmedia.h から KSNODETYPE_Xxx GUID 値の 1 つを取得しますが、一部のカスタム ドライバーでは他の GUID 値が提供される場合があります。 KSNODETYPE_Xxx GUID の詳細については、Windows DDK のドキュメントを参照してください。

IPart インターフェイスで説明されているように、パーツにはコネクタまたはサブユニットを指定できます。

コネクタであるパーツの場合、このメソッドは、ドライバーがコネクタに割り当てたピン カテゴリ GUID を取得します。 ピン カテゴリ GUID の例を次に示します。

• KSNODETYPE_ANALOG_CONNECTOR、コネクタがマイクやスピーカーなどのアナログ デバイスへのデータ パスまたはアナログ デバイスからのデータ パスの一部である場合。
• KSNODETYPE_SPDIF_INTERFACE、コネクタが S/PDIF ポート間のデータ パスの一部である場合です。

サブユニットであるパーツの場合、このメソッドは、サブユニットが実行するストリーム処理関数を示すサブタイプ GUID を取得します。 たとえば、ボリューム制御サブユニットの場合、 メソッドはKSNODETYPE_VOLUME GUID 値を取得します。

次の表に、サブユニットの GetSubType メソッドで取得できるサブタイプ GUID の一部を示します。

上の表の中央の列には、左側の列で指定されたサブタイプのサブユニットでサポートされているコントロール インターフェイスが一覧表示されています。 右側の列は、コントロール インターフェイスに対するサブユニットのサポートが必要か省略可能かを示します。 サポートが必要な場合、アプリケーションは、指定されたサブタイプのサブユニットを使用して制御インターフェイスをサポートできます。 サポートが省略可能な場合、指定したサブタイプのサブユニットは制御インターフェイスをサポートできますが、必ずしもサポートできるとは限りません。

前の表のコントロール インターフェイスを使用すると、サブユニットのプロパティに簡単にアクセスできます。 ただし、一部のサブユニットには、対応するコントロール インターフェイスが存在しないプロパティがあります。 アプリケーションは、 IKsControl インターフェイスを介してこれらのプロパティにアクセスできます。 詳細については、「 IKsControl インターフェイスを使用してオーディオ プロパティにアクセスする」を参照してください。

要件

関連項目

IPart インターフェイス