WdfPdoInitAllocate 函数 (wdfpdo.h)

  • 项目

[仅适用于 KMDF]

WdfPdoInitAllocate 方法为基于框架的总线驱动程序分配WDFDEVICE_INIT结构，总线驱动程序在报告新设备时使用该结构。

语法

PWDFDEVICE_INIT WdfPdoInitAllocate(
  [in] WDFDEVICE ParentDevice
);

参数

[in] ParentDevice

表示新设备的父设备的框架设备对象的句柄。 框架设备对象必须表示 FDO) (功能设备对象。

返回值

如果操作成功，该方法将返回指向框架分配 的WDFDEVICE_INIT 结构的指针。 否则，该方法返回 NULL。

注解

如果总线驱动程序使用静态枚举，它将通过以下方式报告新设备：

  1. 调用 WdfPdoInitAllocate 以分配 WDFDEVICE_INIT 结构。
  2. 根据需要调用 框架设备对象初始化 方法和 框架 PDO 初始化方法，以初始化WDFDEVICE_INIT结构。 如果调用这些方法之一失败，驱动程序必须调用 WdfDeviceInitFree。
  3. 调用 WdfDeviceCreate 以创建框架设备对象，并提供初始化的 WDFDEVICE_INIT 结构作为输入。
有关静态枚举的详细信息，请参阅 枚举总线上的设备。

示例

有关使用 WdfPdoInitAllocate 的代码示例，请参阅 WdfFdoAddStaticChild。

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfpdo.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL PASSIVE_LEVEL
DDI 符合性规则 AddPdoToStaticChildList (kmdf) 、 DoubleDeviceInitFree (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) ， PdoDeviceInitAPI (kmdf) 、 PdoInitFreeDeviceCallback (kmdf) 、 PdoInitFreeDeviceCreate (kmdf) 、 PdoInitFreeDeviceCreateType2 (kmdf) 、 PdoInitFreeDeviceCreateType4 (kmdf)

另请参阅

WdfControlDeviceInitAllocate