EVT_WDF_DEVICE_RESOURCES_QUERY回调函数 (wdfpdo.h)
[仅适用于 KMDF]
总线驱动程序的 EvtDeviceResourcesQuery 事件回调函数创建表示指定设备的 启动配置的资源列表。
语法
EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;
NTSTATUS EvtWdfDeviceResourcesQuery(
[in] WDFDEVICE Device,
[in] WDFCMRESLIST Resources
)
{...}
参数
[in] Device
框架设备对象的句柄。
[in] Resources
表示空资源列表的框架资源列表对象的句柄。
返回值
如果驱动程序未遇到任何错误,则必须返回STATUS_SUCCESS (是否) 指定启动配置资源。 如果驱动程序遇到错误,则必须返回一个 NTSTATUS 值, NT_SUCCESS 计算为 FALSE。
有关此回调函数的返回值的详细信息,请参阅 报告设备故障。
注解
基于框架的总线驱动程序可以提供 EvtDeviceResourcesQuery 回调函数。 若要注册此回调函数,总线驱动程序将调用 WdfPdoInitSetEventCallbacks。
框架调用总线驱动程序的 EvtDeviceResourcesQuery 回调函数以获取指定设备启动配置 的资源列表 。
驱动程序必须使用表示设备的启动要求的硬件资源填充提供的资源列表对象。 PnP 设备的驱动程序从系统 BIOS 获取此要求信息。
若要创建资源列表,驱动程序调用 框架 resource-list 对象方法 ,这些方法将资源添加到 Resources 参数表示 的资源列表对象。有关硬件资源和创建资源列表的详细信息,请参阅 用于 Framework-Based 驱动程序的硬件资源。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
标头 | wdfpdo.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL |