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
标头 ursdevice.h (包括 Urscx.h)
Library Urscxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize