Метод IResourceList::AddEntryFromParent (portcls.h)

Статья
08/07/2023

Метод AddEntryFromParent добавляет в список ресурсов запись, найденную в родительском списке списка ресурсов.

Синтаксис

NTSTATUS AddEntryFromParent(
  [in] IResourceList    *Parent,
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

Параметры

[in] Parent

Указатель на родительский объект IResourceList , из которого должна быть взята запись.

[in] Type

Определяет тип ресурса добавляемой записи. Список допустимых значений типа ресурса см. в описании элемента Type структуры CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Указывает индекс в родительском списке добавляемой записи. Если родительский метод IResourceList::NumberOfEntriesOfType возвращает значение n для количества записей типа Type, допустимые индексы варьируются от 0 до n-1. Например, если значение Index равно нулю, метод добавляет первое вхождение записи указанного типа из родительского списка.

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

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

Код возврата	Описание
STATUS_INSUFFICIENT_RESOURCES	Указывает, что в списке нет свободных записей.
STATUS_INVALID_PARAMETER	Указывает, что запись не найдена в родительском списке.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	portcls.h (включая Portcls.h)
IRQL	PASSIVE_LEVEL

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

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType