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)

另请参阅

KSPIN_INTERFACE

KSPIN_MEDIUM

KSPROPERTY_PIN_DATAFLOW