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_READGENERIC_WRITE。 对于流入引脚的数据,此值应设置为 GENERIC_WRITE,对于流出引脚的数据,应将其设置为 GENERIC_READ 而不考虑通信方法。

[out] ConnectionHandle

指定传递的连接句柄。 该例程使用所创建连接的文件对象的句柄填充此值。 然后,此值可用于与 CloseHandle 函数断开连接。

返回值

如果成功,则返回 NOERROR;否则,返回错误代码。

言论

这是 KsCreatePin 函数的新版本,并使用设备代理创建内核流式处理对象的句柄。 此外,在调用此函数之前,必须调用组件对象模型(COM)CoInitialize 函数。

例程向驱动程序发送 IRP_MJ_CREATE 请求。 驱动程序仅当接口、中等和数据格式兼容时,才接受请求。

如果 Connect->PinToHandleNULLKsCreatePin2 将创建调用方可用于向 Connect中指定的流式处理驱动程序发送请求的 pin>FilterHandleConnect->PinId 确定要创建的引脚类型。

要求

要求 价值
最低支持的客户端 Windows 8
支持的最低服务器 Windows Server 2012
目标平台 普遍
标头 ks.h (包括 Ks.h)
IRQL PASSIVE_LEVEL

另请参阅

CoInitialize

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT

KsCreatePin