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 介面。
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | wudfddi.h (包括 Wudfddi.h) |