BdaMethodCreatePin 函数 (bdasup.h)

项目
02/22/2024

BdaMethodCreatePin 函数创建引脚工厂。

语法

NTSTATUS BdaMethodCreatePin(
  [in]            PIRP      pIrp,
  [in]            PKSMETHOD pKSMethod,
  [out, optional] PULONG    pulPinFactoryID
);

参数

[in] pIrp

指向创建引脚工厂的请求的 IRP。 BDA 微型驱动程序通过 KSMETHOD_BDA_CREATE_PIN_FACTORY 请求接收此 IRP。

[in] pKSMethod

指向描述方法请求的方法和请求类型的 KSMETHOD 结构。

[out, optional] pulPinFactoryID

指向接收引脚工厂标识符的变量。

返回值

返回STATUS_SUCCESS或相应的错误代码。

注解

在微型驱动程序收到来自网络提供程序的 KSMETHODSETID_BdaDeviceConfiguration 方法集的KSMETHOD_BDA_CREATE_PIN_FACTORY请求后，BDA 微型驱动程序调用 BdaMethodCreatePin 函数来创建引脚工厂。大多数 BDA 微型驱动程序可以定义调度表和筛选器自动化表，以便这些微型驱动程序直接调度 BdaMethodCreatePin 函数，而无需使用 KStrMethodHandler () 的内部方法截获此请求。有关详细信息，请参阅定义自动化表和配置 BDA 筛选器。

如果 BDA 微型驱动程序必须创建引脚而不依赖于网络提供程序，则 BDA 微型驱动程序应调用 BdaCreatePin 函数。