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 |