通过

WDFDEVICE_INIT结构

  • 项目

[适用于 KMDF 和 UMDF]

WDFDEVICE_INIT结构是框架定义和分配的不透明结构。

语法

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

成员

函数和筛选器驱动程序接收指向此结构的指针作为 EvtDriverDeviceAdd 回调函数的输入，或作为 WdfControlDeviceInitAllocate 的返回值。

总线驱动程序接收结构指针作为 EvtChildListCreateDevice 回调函数的输入，或作为 WdfPdoInitAllocate 的返回值。

驱动程序收到 WDFDEVICE_INIT 结构后，它会将结构指针传递给初始化函数。 这些函数使用 WDFDEVICE_INIT 结构来存储框架用于创建框架设备对象的信息。

若要查找设备初始化方法的文档，请参阅 wdfdevice.h 标头。

调用初始化函数后，驱动程序必须调用 WdfDeviceCreate 才能创建框架设备对象。

如果驱动程序从调用 WdfPdoInitAllocate 或 WdfControlDeviceInitAllocate 收到WDFDEVICE_INIT结构，并且驱动程序从调用初始化函数收到错误，驱动程序必须调用 WdfDeviceInitFree 而不是 WdfDeviceCreate。

成功调用 WdfDeviceCreate 后，驱动程序不得调用 WdfDeviceInitFree。

WDFDEVICE_INIT结构在 1.0 版和更高版本的 KMDF 中可用。

要求

头文件

 Wdftypes.h （包括 Wdftypes.h）