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