IKsPin::KsGetCurrentCommunication 方法 (ksproxy.h)
KsGetCurrentCommunication 方法检索引脚的当前通信方向、接口和介质。
语法
HRESULT KsGetCurrentCommunication(
[out, optional] KSPIN_COMMUNICATION *Communication,
[out, optional] KSPIN_INTERFACE *Interface,
[out, optional] KSPIN_MEDIUM *Medium
);
参数
[out, optional] Communication
指向变量的指针,该变量从描述引脚当前通信方向的KSPIN_COMMUNICATION枚举类型接收以下值之一:
值 | 说明 |
---|---|
KSPIN_COMMUNICATION_NONE | 引脚工厂不会创建任何固定实例。 |
KSPIN_COMMUNICATION_SINK | 引脚工厂创建 IRP 接收器引脚的实例。 此类引脚只能连接到 IRP 源引脚。 |
KSPIN_COMMUNICATION_SOURCE | 引脚工厂创建 IRP 源引脚的实例。 此类引脚只能连接到 IRP 接收器引脚。 |
KSPIN_COMMUNICATION_BOTH | 引脚工厂创建既是 IRP 接收器又是 IRP 源的引脚实例。 |
KSPIN_COMMUNICATION_BRIDGE | 引脚无法连接到其他引脚,但可以在其上创建实例以接收非 KS I/O 请求。 |
[out, optional] Interface
指向变量的指针,该变量接收描述引脚当前接口的 KSPIN_INTERFACE 结构。
[out, optional] Medium
指向一个变量的指针,该变量接收描述引脚当前介质的 KSPIN_MEDIUM 结构。
返回值
如果成功,则返回 NOERROR;否则,将返回错误代码。
注解
源引脚将 IRP 发送到接收器引脚。 不要将通信方向与数据流方向混淆。 (请参阅 KSPROPERTY_PIN_DATAFLOW.) 源引脚可以读取或写入数据,接收器引脚可能具有读取或写入数据。
引脚的当前通信方向、接口和介质是引脚可用的通信方向、接口和介质的子集,是在创建引脚句柄时选择的。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | ksproxy.h (包括 Ksproxy.h) |