WdfIoResourceListGetDescriptor 函数 (wdfresource.h)

[仅适用于 KMDF]

WdfIoResourceListGetDescriptor 方法返回指向资源要求列表 逻辑配置中包含的资源描述符的指针。

语法

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

参数

[in] ResourceList

框架资源范围列表对象的句柄,该对象表示设备的硬件资源的逻辑配置。

[in] Index

用作 ResourceList 指定的逻辑配置的索引的从零开始的值。

返回值

WdfIoResourceListGetDescriptor 返回指向 IO_RESOURCE_DESCRIPTOR 结构的指针,该结构描述 Index 参数标识的硬件资源(如果索引值有效)。 否则,该方法将返回 NULL

如果驱动程序提供无效的对象句柄,则会发生系统 bug 检查。

言论

驱动程序无法修改 WdfIoResourceListGetDescriptor 检索的 IO_RESOURCE_DESCRIPTOR 结构的内容。 若要修改资源描述符,驱动程序可以调用 WdfIoResourceListUpdateDescriptor

有关资源要求列表和逻辑配置的详细信息,请参阅 Framework-Based 驱动程序的硬件资源

例子

有关使用 WdfIoResourceListGetDescriptor的代码示例,请参阅 WdfIoResourceRequirementsListGetIoResList

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
标头 wdfresource.h (包括 Wdf.h)
Wdf01000.sys(请参阅框架库版本控制。
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf)

另请参阅

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor