IPnpCallbackHardware2::OnReleaseHardware 方法 (wudfddi.h)
[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。]
OnReleaseHardware 方法执行设备不再可访问时所需的操作。
语法
HRESULT OnReleaseHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
参数
[in] pWdfDevice
指向框架设备对象的 IWDFDevice3 接口的指针。
[in] pWdfResourcesTranslated
指向框架资源列表对象的 IWDFCmResourceList 接口的指针,该对象标识即插即用管理器分配给设备的已翻译硬件资源。
返回值
如果操作成功,OnReleaseHardware 将返回S_OK。 否则,此方法返回 Winerror.h 中定义的错误代码之一。 不要返回HRESULT_FROM_NT (STATUS_NOT_SUPPORTED) 。
注解
当驱动程序调用 IWDFDriver::CreateDevice 方法来创建设备对象时,驱动程序注册 IPnpCallbackHardware2 接口。
无论 OnPrepareHardware 成功还是失败,OnReleaseHardware 方法都必须释放在调用驱动程序的 IPnpCallbackHardware2::OnPrepareHardware 方法期间分配的资源。 因此, OnReleaseHardware 必须能够处理部分资源的清理。
有关删除中断对象的信息,请参阅 删除中断对象。
有关分析硬件资源的信息,请参阅 在 UMDF 驱动程序中查找和映射硬件资源。
示例
请参阅 IWDFDevice3::MapIoSpace 中的示例代码。
要求
要求 | 值 |
---|---|
结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.11 |
标头 | wudfddi.h |