KsCreatePin2 函数 (ks.h)
将连接请求传递到设备，创建固定实例。
支持从 Windows 8 开始。
语法
KSDDKAPI HRESULT KsCreatePin2(
[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 函数断开连接。
返回值
如果成功，则返回 NOERROR ;否则，将返回错误代码。
注解
这是 KsCreatePin 函数的新版本，使用设备代理创建内核流式处理对象的句柄。 此外，在调用此函数之前，必须调用组件对象模型 (COM) CoInitialize 函数。
例程向驱动程序发送 IRP_MJ_CREATE 请求。 仅当接口、介质和数据格式兼容时，驱动程序才接受请求。
如果 Connect-PinToHandle> 为 NULL，KsCreatePin2 会创建一个引脚，调用方可以使用该引脚将请求发送到 Connect-FilterHandle> 中指定的流式处理驱动程序。 Connect-PinId> 确定要创建的引脚类型。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 |
| 最低受支持的服务器 | Windows Server 2012 |
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| IRQL | PASSIVE_LEVEL |