IConnector::GetType メソッド (devicetopology.h)

GetType メソッドは、このコネクタの型を取得します。

構文

HRESULT GetType(
  [out] ConnectorType *pType
);

パラメーター

[out] pType

メソッドがコネクタ型を書き込む変数へのポインター。 コネクタの種類は、次のいずれかの ConnectorType 列挙定数です。

Unknown_Connector

Physical_Internal

Physical_External

Software_IO

Software_Fixed

ネットワーク

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
E_POINTER
ポインター pTypeNULL です

注釈

コネクタは、カーネル ストリーミング (KS) の用語の "ピン" に対応します。 コネクタへの KS ピンのマッピングは次のとおりです。

  • KS ピン通信の種類がKSPIN_COMMUNICATION_SINK、KSPIN_COMMUNICATION_SOURCE、またはKSPIN_COMMUNICATION_BOTHの場合、コネクタの種類はSoftware_IO。
  • それ以外の場合、ピンが同じオーディオ アダプターまたは異なるオーディオ アダプター内の 2 つの KS フィルター (デバイス) 間の物理的な接続の一部である場合、コネクタの種類はSoftware_Fixed。
  • それ以外の場合、KS ピン カテゴリがKSNODETYPE_SPEAKER、KSNODETYPE_MICROPHONE、KSNODETYPE_LINE_CONNECTOR、またはKSNODETYPE_SPDIF_INTERFACEの場合、コネクタの種類はPhysical_External。
  • それ以外の場合、上記の条件を満たしていないピンの場合、コネクタの種類はPhysical_Internal。
KS ピンの詳細については、Windows DDK のドキュメントを参照してください。

GetType メソッドを呼び出すコード例については、デバイス トポロジでの SelectCaptureDevice 関数の実装に関するページを参照してください。

要件

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

こちらもご覧ください

IConnector インターフェイス