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 を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。
リターン コード | 説明 |
---|---|
|
ポインター pType は NULL です。 |
注釈
コネクタは、カーネル ストリーミング (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。
GetType メソッドを呼び出すコード例については、デバイス トポロジでの SelectCaptureDevice 関数の実装に関するページを参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | devicetopology.h |