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 FALSE。

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

注解

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

该框架调用总线驱动程序的 EvtDeviceResourcesQuery 回调函数来获取指定设备的启动配置的 资源列表。

驱动程序必须使用表示设备启动要求的硬件资源填充提供的资源列表对象。 PnP 设备的驱动程序从系统 BIOS 获取此要求信息。

若要创建资源列表，驱动程序调用 框架资源列表对象方法，该方法将资源添加到由 Resources 参数表示的资源列表对象。有关硬件资源和创建资源列表的详细信息，请参阅 Framework-Based 驱动程序的硬件资源。

要求

另请参阅

EvtDeviceResourceRequirementsQuery