KSPIN_CONNECT结构 (ks.h)

客户端使用KSPIN_CONNECT结构描述他们在 KsCreatePin 调用中从驱动程序请求的连接。

语法

typedef struct {
  KSPIN_INTERFACE Interface;
  KSPIN_MEDIUM    Medium;
  ULONG           PinId;
  HANDLE          PinToHandle;
  KSPRIORITY      Priority;
} KSPIN_CONNECT, *PKSPIN_CONNECT;

成员

Interface

指定要用于此连接的 KSPIN_INTERFACE

Medium

类型 KSPIN_MEDIUM 的结构,指定要用于此连接的介质。

PinId

指定引脚类型 ID 号。 如果 PinToHandle 字段不 为 NULL,则此字段包含要向其发送请求的源引脚的标识符。 否则,此字段是指要连接的接收器引脚。 如果引脚可以同时支持在通信中同时成为源和接收器,则这是说明它在连接中应如何操作的隐式方法。

PinToHandle

指定创建所针对的目标引脚类型,在源目标的情况下,要连接到哪个引脚。 当客户端请求与自身建立连接时,此成员为 NULL 。 否则,它是连接请求的目标。 如果源目标为源目标,则包含用于建立连接的引脚实例的句柄。 对于接收器目标,此字段包含 NULL,否则不使用。

Priority

KSPRIORITY 类型的结构,指定连接优先级,通常KSPRIORITY_NORMAL。 有关详细信息 ,请参阅KSPROPERTY_CONNECTION_PRIORITY 属性。

注解

如果KSPIN_CONNECT。PinToHandle 元素不 为 NULL,IRP_MJ_CREATE指示设备连接源KSPIN_CONNECT。PinId 固定到KSPIN_CONNECT。PinToHandle 固定实例。 否则,这是从客户端请求连接到KSPIN_CONNECT。使用 KSPIN_CONNECT 的 PinId 引脚。中等方法和连接结构后指定的特定数据格式。 在任一情况下,如果无法接受此连接,设备驱动程序可能会失败此请求。

要求

   
Header ks.h (包括 Ks.h)

另请参阅

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin