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

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

返回值

如果驱动程序未遇到任何错误,则它必须返回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

另请参阅

EvtDeviceResourcesQuery