BdaMethodCreatePin 函数（bdasup.h）

项目
02/06/2025

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或适当的错误代码。

言论

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

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