EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY回调函数 (wdfpdo.h)

[仅适用于 KMDF]

总线驱动程序的 EvtDeviceResourceRequirementsQuery 事件回调函数创建表示设备所需硬件资源的资源要求列表。

语法

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

参数

[in] Device

框架设备对象的句柄。

[in] IoResourceRequirementsList

表示空资源要求列表的框架 resource-requirements-list 对象的句柄。

返回值

如果驱动程序未遇到任何错误，则必须返回STATUS_SUCCESS (是否指定任何必需的硬件资源) 。 如果驱动程序遇到错误，则必须返回 NT_SUCCESS 计算为 FALSE 的 NTSTATUS 值。

有关此回调函数的返回值的详细信息，请参阅 报告设备故障。

注解

基于框架的总线驱动程序可以提供 EvtDeviceResourceRequirementsQuery 回调函数。 若要注册此回调函数，总线驱动程序调用 WdfPdoInitSetEventCallbacks。

框架调用总线驱动程序的 EvtDeviceResourceRequirementsQuery 回调函数以获取设备 的资源要求列表 。

驱动程序必须使用允许设备正常运行的硬件资源的逻辑配置填充所提供的 resource-requirements-list 对象。

为了创建资源要求列表，驱动程序调用 框架 resource-range-list 对象方法（将资源描述符添加到逻辑配置）和框架 resource-requirements-list 对象方法（将逻辑配置添加到资源要求列表）。

有关硬件资源和创建资源要求列表的详细信息，请参阅 Framework-Based 驱动程序的硬件资源。

如果驱动程序在早于 Windows 7 的操作系统版本上运行，则总线驱动程序可以使用 EvtDeviceResourceRequirementsQuery 在枚举子设备上 设置设备属性 。

若要在 Windows 7 或更高版本上设置设备属性，总线驱动程序可以为IRP_MN_DEVICE_ENUMERATED提供预处理例程。

要求

要求	值
目标平台	通用
最低 KMDF 版本	1.0
标头	wdfpdo.h (包括 Wdf.h)
IRQL	PASSIVE_LEVEL

另请参阅

EvtDeviceResourcesQuery