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