Функция UrsIoResourceListAppendDescriptor (ursdevice.h)

Добавляет указанный дескриптор ресурса к указанному объекту списка ресурсов ввода-вывода, который поддерживает дескрипторы ресурсов для роли узла или функции.

Синтаксис

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

Параметры

[in] IoResourceList

Объект списка ресурсов ввода-вывода роли, к которому добавляется дескриптор ресурса. Этот объект выделяется платформой и передается драйверу клиента при вызове платформы 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.

Дополнительные сведения о списках требований к ресурсам см. в обработке аппаратных ресурсов.

Требования

См. также

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize