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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[out] OutResourceList

Указатель вывода на объект списка ресурсов, который создает эта функция. Этот параметр указывает на переменную указателя, выделенную вызывающим объектом, в которую функция выводит указатель на объект 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 ParentList соответствуют соглашениям подсчета ссылок для объектов COM.

Требования

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

См. также

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE

Поделиться через