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

另請參閱

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements