Функция 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 |