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。 否則，它必須傳回 NT_SUCCESS 評估為 FALSE 的 NTSTATUS 值。
如需傳回值的詳細資訊，請參閱 報告裝置失敗。
備註
架構型函式驅動程式可以提供 EvtDeviceRemoveAddedResources 回呼函式 。 若要註冊此回呼函式，驅動程式會呼叫 WdfFdoInitSetEventCallbacks。
如果驅動程式提供 EvtDeviceFilterAddResourceRequirements 回呼函式，以將資源新增至裝置的硬體需求清單，驅動程式也必須提供 EvtDeviceRemoveAddedResources 回呼函式。 EvtDeviceRemoveAddedResources 回呼函式會檢查 PnP 管理員已指派給裝置的資源清單，並從 EvtDeviceFilterAddResourceRequirements 回呼函式新增的清單中移除資源。 如果驅動程式移除資源，則必須將它從原始和翻譯的資源清單中移除。
如需資源清單和資源出現順序的詳細資訊，請參閱 原始和翻譯的硬體資源。
架構會在將裝置的資源清單傳遞至總線驅動程式之前，立即呼叫驅動程式的 EvtDeviceRemoveAddedResources 回呼函式。 此回呼函式會移除新增的資源，讓總線驅動程式不會嘗試使用這些資源。
如需 EvtDeviceRemoveAddedResources 回呼函式的詳細資訊，請參閱 修改資源清單。
如需硬體資源的詳細資訊，請參閱 Framework-Based 驅動程式的硬體資源。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdffdo.h (包含 Wdf.h) |
| IRQL | PASSIVE_LEVEL |