IResourceList::AddEntryFromParent 方法 (portcls.h)

方法會將 AddEntryFromParent 專案加入至資源清單的父清單中找到的專案。

語法

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

參數

[in] Parent

要從中擷取專案之父 IResourceList 物件的指標。

[in] Type

識別要加入之項目的資源類型。 如需有效資源類型值的清單,請參閱 CM_PARTIAL_RESOURCE_DESCRIPTOR 結構的 Type 成員描述。

[in] Index

指定要加入之專案的父清單中索引。 如果父系的 IResourceList::NumberOfEntriesOfType 方法針對 Type 類型的項目數傳回 n 值,有效的索引範圍從 0 到 n-1。 例如,如果 Index 為零,則方法會從父清單中新增指定類型之專案的第一個出現專案。

傳回值

AddEntryFromParent 如果呼叫成功,則會傳回STATUS_SUCCESS。 否則,方法會傳回適當的錯誤碼。 下表顯示一些可能的傳回狀態代碼。

傳回碼 Description
STATUS_INSUFFICIENT_RESOURCES
表示清單中沒有免費專案。
STATUS_INVALID_PARAMETER
指出父清單中找不到專案。

備註

針對每個資源類型,會定義宏來呼叫此方法。 請參閱 IResourceList

Parent 參數會遵循 COM 對象的參考計數慣例

規格需求

需求
目標平台 Universal
標頭 portcls.h (包括 Portcls.h)
IRQL PASSIVE_LEVEL

另請參閱

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType