[仅适用于 KMDF]
总线驱动程序的 EvtDeviceResourceRequirementsQuery 事件回调函数创建资源要求列表,该列表表示设备所需的硬件资源。
语法
EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;
NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
[in] WDFDEVICE Device,
[in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}
参数
[in] Device
框架设备对象的句柄。
[in] IoResourceRequirementsList
表示空资源要求列表的框架资源要求列表对象的句柄。
返回值
如果驱动程序未遇到任何错误,则它必须返回STATUS_SUCCESS(无论它是否指定任何所需的硬件资源)。 如果驱动程序遇到错误,它必须返回一个 NTSTATUS 值,NT_SUCCESS 计算为 FALSE FALSE。
有关此回调函数的返回值的详细信息,请参阅 报告设备故障。
注解
基于框架的总线驱动程序可以提供 EvtDeviceResourceRequirementsQuery 回调函数。 若要注册此回调函数,总线驱动程序调用 WdfPdoInitSetEventCallbacks。
该框架调用总线驱动程序的 EvtDeviceResourceRequirementsQuery 回调函数,以获取设备的 资源要求列表。
驱动程序必须使用硬件资源的逻辑配置填充提供的 resource-requirements-list 对象,这些配置将允许设备正常运行。
为了创建资源要求列表,驱动程序调用 框架资源范围列表对象方法,该方法将资源描述符添加到逻辑配置,以及框架资源要求列表对象方法,该方法将逻辑配置添加到资源要求列表。
有关硬件资源和创建资源要求列表的详细信息,请参阅 Framework-Based 驱动程序的硬件资源。
如果驱动程序在早于 Windows 7 的作系统版本上运行,则总线驱动程序可以在枚举子设备之前使用 EvtDeviceResourceRequirementsQuery 来 在子设备上设置设备属性。
若要在 Windows 7 或更高版本上 设置设备属性,总线驱动程序可以 为 IRP_MN_DEVICE_ENUMERATED提供预处理例程。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
最低 KMDF 版本 | 1.0 |
标头 | wdfpdo.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL |