UrsIoResourceListAppendDescriptor 函数 (ursdevice.h)

将指定的资源描述符追加到指定的 I/O 资源列表对象,该对象维护主机或函数角色的资源描述符。

语法

NTSTATUS UrsIoResourceListAppendDescriptor(
  [in] URSIORESLIST            IoResourceList,
  [in] PIO_RESOURCE_DESCRIPTOR Descriptor
);

参数

[in] IoResourceList

将资源描述符追加到的角色的 I/O 资源列表对象。 此对象由框架分配,并在框架调用驱动程序的 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS 实现时传递给客户端驱动程序。

[in] Descriptor

指向包含角色的资源描述符的IO_RESOURCE_DESCRIPTOR的指针。

返回值

如果作成功,该方法将返回STATUS_SUCCESS。 否则,此方法可能会返回相应的 NTSTATUS 错误代码。

言论

客户端驱动程序调用 UrsDeviceInitialize后,框架会为 资源要求列表分配内存。 当 USB 双角色类扩展调用客户端驱动程序的 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS实现时,它将 WDFIORESREQLIST 句柄传递给该要求列表,以及主机和函数角色的 URSIORESLIST 句柄 资源列表。 在实现中,客户端驱动程序应通过要求列表枚举,并将资源描述符(如果想要使用该资源)添加到每个角色的资源列表中。

若要为角色添加资源描述符,驱动程序将调用 UrsIoResourceListAppendDescriptor,并指定必须向其添加资源的描述符和资源列表。

有关代码示例,请参阅 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

有关资源要求列表的详细信息,请参阅 处理硬件资源

要求

要求 价值
最低支持的客户端 Windows 10
支持的最低服务器 Windows Server 2016
目标平台 窗户
最低 KMDF 版本 1.15
标头 ursdevice.h (包括 Urscx.h)
Urscxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize