Функция PcNewResourceSublist (portcls.h)

  • Статья

Функция PcNewResourceSublist создает и инициализирует пустой список ресурсов, производный от другого списка ресурсов.

Синтаксис

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

Параметры

[out] OutResourceList

Выходной указатель на объект resource-list, создаваемый этой функцией. Этот параметр указывает на выделенную вызывающим элементом переменную указателя, в которую функция выводит указатель на объект IResourceList . Укажите допустимое значение указателя, отличное от NULL , для этого параметра.

[in, optional] OuterUnknown

Указатель на интерфейс IUnknown объекта, который должен агрегировать объект. Если агрегирование не требуется, присвойте этому параметру значение NULL.

[in] PoolType

Указывает тип пула, из которого будет выделен объект. Это значение перечисления POOL_TYPE .

[in] ParentList

Указатель на список ресурсов, из которого будет создан дочерний список. Список ресурсов имеет интерфейс IResourceList .

[in] MaximumEntries

Указывает максимальное количество записей, которые будут добавлены в список ресурсов.

Возвращаемое значение

PcNewResourceSublist возвращает STATUS_SUCCESS, если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки.

Комментарии

Эта функция создает пустой подлист ресурсов.

Драйвер адаптера обычно использует функцию PcNewResourceSublist в сочетании с методом IResourceList::AddEntryFromParent , чтобы получить исходный список ресурсов, полученных от системы, и разделить их на вложенные списки, назначенные ему различным подустройствам.

Параметры OutResourceList, OuterUnknown и ParentList следуют соглашениям о подсчете ссылок для COM-объектов.

Требования

Требование Значение
Минимальная версия клиента Системный драйвер PortCls реализует функцию PcNewResourceSublist в Microsoft Windows 98/Me, а также в операционных системах Windows 2000 и более поздних версий.
Целевая платформа Универсальное
Верхняя часть portcls.h (включая Portcls.h)
Библиотека Portcls.lib
IRQL PASSIVE_LEVEL

См. также раздел

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE