通过

KsValidateConnectRequest 函数 （ks.h）

  • 项目

KsValidateConnectRequest 函数验证连接请求，并返回指向与请求关联的连接结构的指针。

此函数只能在PASSIVE_LEVEL调用。

语法

KSDDKAPI NTSTATUS KsValidateConnectRequest(
  [in]  PIRP                   Irp,
  [in]  ULONG                  DescriptorsCount,
  [in]  const KSPIN_DESCRIPTOR *Descriptor,
  [out] PKSPIN_CONNECT         *Connect
);

参数

[in] Irp

指向指定连接请求的 IRP 的指针。

[in] DescriptorsCount

指定传递的引脚描述符数。

[in] Descriptor

指定指向 KSPIN_DESCRIPTOR 结构的列表的指针。

[out] Connect

指定将指针置于传递给创建请求 KSPIN_CONNECT 指针的位置。 如果 KsValidateConnectRequest 返回成功，则 Connect+1 将包含指向打开引脚的 KSDATAFORMAT 的指针。

返回值

KsValidateConnectRequest 函数在成功时返回STATUS_SUCCESS，或者返回错误。

言论

KsValidateConnectRequest 函数处理基本的连接结构访问异常，并验证通信要求、中等、协议和基本数据格式。 对传递的数据格式执行的验证基于要为其创建固定实例的指定引脚的数据范围列表。 验证在三个实例中成功：如果范围主要格式是通配符，范围主要格式匹配，范围子格式为通配符，或者范围主要格式、范围子格式和范围说明符全部匹配。

如果原始输入缓冲区未处于内核模式，则缓冲区将传递原始输入缓冲区的副本，因此是安全的。

要求

要求 价值
目标平台 普遍
标头 ks.h （包括 Ks.h）
库 Ks.lib