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

Статья
02/07/2025

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

Указатель вывода для объекта списка ресурсов, созданного этой функцией. Этот параметр указывает на переменную указателя, выделенную вызывающим объектом, в которую функция выводит указатель на объект 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 (include Portcls.h)
библиотеки	Portcls.lib
IRQL	PASSIVE_LEVEL

См. также

CM_RESOURCE_LIST

IResourceList

POOL_TYPE

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