Функция PcNewResourceList (portcls.h)
Функция PcNewResourceList создает и инициализирует список ресурсов.
Синтаксис
PORTCLASSAPI NTSTATUS PcNewResourceList(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PCM_RESOURCE_LIST TranslatedResources,
[in] PCM_RESOURCE_LIST UntranslatedResources
);
Параметры
[out] OutResourceList
Выходной указатель для объекта resource-list, созданного этой функцией. Этот параметр указывает на переменную указателя, выделенную вызывающим объектом, в которую функция выводит указатель на объект IResourceList . Укажите допустимое значение указателя, отличное от NULL , для этого параметра.
[in, optional] OuterUnknown
Указатель на интерфейс IUnknown объекта, который должен агрегировать объект списка ресурсов. Если агрегирование не требуется, присвойте этому параметру значение NULL.
[in] PoolType
Указывает тип пула, из которого будет выделен объект. Это значение перечисления POOL_TYPE .
[in] TranslatedResources
Указатель на предоставленный WDM список ресурсов для переведенных ресурсов. Список представляет собой системную структуру типа CM_RESOURCE_LIST.
[in] UntranslatedResources
Указатель на предоставленный WDM список ресурсов для непереводимых ресурсов. Список представляет собой системную структуру типа CM_RESOURCE_LIST.
Возвращаемое значение
PcNewResourceList возвращает STATUS_SUCCESS, если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки.
Комментарии
Описание переведенных и непереводимых (или "необработанных") списков ресурсов см. в разделе Сопоставление адресов Bus-Relative с виртуальными адресами.
Параметры OutResourceList и OuterUnknown следуют соглашениям о подсчете ссылок для COM-объектов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Системный драйвер PortCls реализует функцию PcNewResourceList в Microsoft Windows 98/Me, а также в операционных системах Windows 2000 и более поздних версий. |
| Целевая платформа | Универсальное |
| Верхняя часть | portcls.h (включая Portcls.h) |
| Библиотека | Portcls.lib |
| IRQL | PASSIVE_LEVEL |