IPnpCallbackHardware：：OnReleaseHardware 方法 (wudfddi.h)

發行項
02/27/2024

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

OnReleaseHardware 方法會通知驅動程式在無法再存取指定的硬體時執行所需的作業。

語法

HRESULT OnReleaseHardware(
  [in] IWDFDevice *pWdfDevice
);

參數

[in] pWdfDevice

無法再存取之裝置物件的 IWDFDevice 介面指標。

傳回值

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

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

備註

驅動程式會在驅動程式呼叫 IWDFDriver：：CreateDevice 方法來建立裝置物件時，註冊 IPnpCallbackHardware 介面。

OnReleaseHardware 方法必須釋放在呼叫驅動程式 IPnpCallbackHardware：：OnPrepareHardware 方法期間配置的資源，不論 OnPrepareHardware 成功還是失敗。因此， OnReleaseHardware 必須能夠處理部分資源的清除。

如需詳細資訊，請參閱在UMDF驅動程式中尋找和對應硬體資源。