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) |