IDriverEntry：：OnInitialize 方法 （wudfddi.h）

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1，并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅 UMDF入门 。]

OnInitialize 方法执行初始化驱动程序所需的任何作。

语法

HRESULT OnInitialize(
  [in] IWDFDriver *pWdfDriver
);

参数

[in] pWdfDriver

指向框架驱动程序对象的 IWDFDriver 接口的指针，该接口表示在主机进程中加载的驱动程序。

返回值

如果驱动程序完成全局初始化，OnInitialize 将返回S_OK。 否则，此方法返回在 Winerror.h 中定义的错误代码之一。 如果驱动程序返回错误代码，框架将不会加载驱动程序。

言论

该框架为驱动程序主机进程中加载的每个驱动程序创建新的驱动程序对象。 当驱动程序进入系统时，框架调用 OnInitialize 来通知驱动程序，并在调用中传递 IWDFDriver 接口。

要求

另请参阅

IDriverEntry

IWDFDriver