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
目标平台 Windows
最低 KMDF 版本 1.15
Header ursdevice.h (包括 Urscx.h)
Library Urscxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize