KsCreatePin 函数 (ks.h)
KsCreatePin 函数将连接请求传递给设备，从而创建 pin 实例。 只能在内核模式客户端 PASSIVE_LEVEL 调用此函数。
语法
KSDDKAPI NTSTATUS KsCreatePin(
[in] HANDLE FilterHandle,
[in] PKSPIN_CONNECT Connect,
[in] ACCESS_MASK DesiredAccess,
[out] PHANDLE ConnectionHandle
);
参数
[in] FilterHandle
指定启动创建请求的筛选器的句柄以及连接发生的位置。
[in] Connect
指向包含所请求连接参数 的 KSPIN_CONNECT 结构的指针。 这应该在内存中后跟 KSDATAFORMAT 数据结构，描述为连接请求的数据格式。
[in] DesiredAccess
指定对引脚所需的访问权限。 这通常是 GENERIC_READ 或 GENERIC_WRITE。 对于流入引脚的数据，此值应设置为 GENERIC_WRITE，对于流出引脚的数据，此值应设置为 GENERIC_READ 而不考虑通信方法。
[out] ConnectionHandle
指定传递的连接句柄。 例程使用所创建连接的文件对象的句柄填充此 。 然后，可以使用此值与 CloseHandle 函数断开连接。
返回值
如果连接成功， KsCreatePin 函数将返回 STATUS_SUCCESS ;如果连接失败，则返回错误。 此外，可以从 Winerror.h) (返回此 Win32 错误代码：
注解
例程向驱动程序发送 IRP_MJ_CREATE 请求。 仅当接口、介质和数据格式兼容时，驱动程序才接受请求。
如果 Connect-PinToHandle> 为 NULL，则 KsCreatePin 会创建一个 PIN，调用方可以使用该引脚将请求发送到 Connect-FilterHandle> 中指定的流式处理驱动程序。 Connect-PinId> 确定要创建的引脚的引脚类型。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| Library | Ks.lib |