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) |