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。
- 否则,如果引脚是两个 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 |