IPnpCallbackHardware：：OnPrepareHardware 方法 (wudfddi.h)

發行項
03/01/2024

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

OnPrepareHardware 方法會通知驅動程式讓指定的硬體可供存取。

語法

HRESULT OnPrepareHardware(
  [in] IWDFDevice *pWdfDevice
);

參數

[in] pWdfDevice

IWDFDevice 介面的指標，可讓裝置的裝置物件可供存取。

傳回值

OnPrepareHardware 會在作業成功時傳回S_OK。否則，此方法會傳回 Winerror.h 中定義的其中一個錯誤碼。請勿傳回HRESULT_FROM_NT (STATUS_NOT_SUPPORTED) 。

如果 OnPrepareHardware 傳回錯誤碼，架構仍會呼叫 IPnpCallbackHardware：：OnReleaseHardware 方法。 OnReleaseHardware 方法接著可以釋放在呼叫 OnPrepareHardware 期間配置的資源。因為 OnReleaseHardware 必須釋放 OnPrepareHardware 成功和失敗案例的資源，所以必須能夠處理部分資源的清除。

這個方法必須使用 HRESULT_FROM_NT 宏，傳回特定的 HRESULT 值，以將狀態傳回至核心模式用戶端。如需詳細資訊，請參閱支援核心模式用戶端。