EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES回呼函式 （wdffdo.h）
[僅適用於 KMDF]
驅動程式 EvtDeviceRemoveAddedResources 事件回呼函式會移除驅動程式 EvtDeviceFilterAddResourceRequirements 回呼函式新增的硬體資源。
語法
EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;
NTSTATUS EvtWdfDeviceRemoveAddedResources(
[in] WDFDEVICE Device,
[in] WDFCMRESLIST ResourcesRaw,
[in] WDFCMRESLIST ResourcesTranslated
)
{...}
參數
[in] Device
要指派資源的架構裝置物件的句柄。
[in] ResourcesRaw
資源清單物件的句柄，識別 PnP 管理員指派給裝置的原始硬體資源。
[in] ResourcesTranslated
資源清單物件的句柄，識別 PnP 管理員指派給裝置的已翻譯硬體資源。
返回值
如果驅動程式未發生任何錯誤，則必須傳回STATUS_SUCCESS。 否則，它必須傳回NTSTATUS值，NT_SUCCESS 評估為 FALSE 。
如需傳回值的詳細資訊，請參閱 報告裝置失敗。
備註
架構型函式驅動程式可以提供 EvtDeviceRemoveAddedResources 回呼函式。 若要註冊此回呼函式，驅動程式會呼叫 WdfFdoInitSetEventCallbacks。
如果驅動程式提供 EvtDeviceFilterAddResourceRequirements 回呼函式，將資源新增至裝置的硬體需求清單，驅動程式也必須提供 EvtDeviceRemoveAddedResources 回呼函式。 EvtDeviceRemoveAddedResources 回呼函式會檢查 PnP 管理員已指派給裝置的資源清單，並從 EvtDeviceFilterAddResourceRequirements 回呼函式新增的清單中移除資源。 如果驅動程式移除資源，它必須從原始和翻譯的資源清單中移除它。
如需資源清單和資源出現順序的詳細資訊，請參閱 原始和轉譯的硬體資源。
架構會在將裝置的資源清單傳遞至總線驅動程式之前，立即呼叫驅動程式的 EvtDeviceRemoveAddedResources 回呼函式。 此回呼函式會移除新增的資源，讓總線驅動程式不會嘗試使用這些資源。
如需 EvtDeviceRemoveAddedResources 回呼函式的詳細資訊，請參閱 修改資源清單。
如需硬體資源的詳細資訊，請參閱 Framework-Based 驅動程式的硬體資源。
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標題 | wdffdo.h （包括 Wdf.h） |
| IRQL | PASSIVE_LEVEL |