IDriverEntry：：OnInitialize 方法 (wudfddi.h)

  • 發行項

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #D61AD7F5ADF5747B69F8E003D7E26FFE1 上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]

OnInitialize 方法會執行初始化驅動程式所需的任何作業。

語法

HRESULT OnInitialize(
  [in] IWDFDriver *pWdfDriver
);

參數

[in] pWdfDriver

架構驅動程式物件的 IWDFDriver 介面指標，代表裝載進程中載入的驅動程式。

傳回值

如果驅動程式已完成全域初始化，OnInitialize 會傳回S_OK。 否則，這個方法會傳回 Winerror.h 中定義的其中一個錯誤碼。 如果驅動程式傳回錯誤碼，架構將不會載入驅動程式。

備註

架構會針對驅動程式主機進程中載入的每個驅動程式建立新的驅動程序物件。 當驅動程式進入系統時，架構會呼叫 OnInitialize 以通知驅動程式，並在呼叫中傳遞 IWDFDriver 介面。

規格需求

需求 值
目標平台 Windows
標頭 wudfddi.h (包含 Wudfddi.h)

另請參閱

IDriverEntry

IWDFDriver