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)
Library Ks.lib