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

  • [アーティクル]

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

構文

HRESULT GetSubType(
  [out] GUID *pSubType
);

パラメーター

[out] pSubType

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

戻り値

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

リターン コード 説明
E_POINTER
 ポインター pSubType は NULL です。

解説

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

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

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

  • KSNODETYPE_ANALOG_CONNECTOR、コネクタがマイクやスピーカーなどのアナログ デバイスへのデータ パスまたはアナログ デバイスからのデータ パスの一部である場合。
  • KSNODETYPE_SPDIF_INTERFACE、コネクタが S/PDIF ポート間のデータ パスの一部である場合です。
詳細については、Windows DDK ドキュメントの pin-category プロパティKSPROPERTY_PIN_CATEGORYの説明を参照してください。

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

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

サブタイプ GUID コントロール インターフェイス 必須または省略可能
KSNODETYPE_3D_EFFECTS IAudioChannelConfig 省略可能
KSNODETYPE_AGC IAudioAutoGainControl 必須
KSNODETYPE_DAC IAudioChannelConfig 省略可能
KSNODETYPE_DEMUX IAudioOutputSelector 必須
KSNODETYPE_DEV_SPECIFIC IDeviceSpecificProperty 必須
KSNODETYPE_LOUDNESS IAudioLoudness 必須
KSNODETYPE_MUTE IAudioMute 必須
KSNODETYPE_MUX IAudioInputSelector 必須
KSNODETYPE_PEAKMETER IAudioPeakMeter 必須
KSNODETYPE_PROLOGIC_DECODER IAudioChannelConfig 省略可能
KSNODETYPE_TONE IAudioBass

IAudioMidrange

IAudioTreble

 OptionalOptional

省略可能
KSNODETYPE_VOLUME IAudioChannelConfig

IAudioVolumeLevel

 OptionalRequired
 

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

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

要件

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

関連項目

IPart インターフェイス