共用方式為


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 結構 類型 成員的描述。

[in] Index

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

傳回值

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

傳回碼 描述
STATUS_INSUFFICIENT_RESOURCES
表示清單中沒有免費專案。
STATUS_INVALID_PARAMETER
表示在父清單中找不到專案。

言論

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

Parent 參數遵循 COM 物件的 參考計數慣例,

要求

要求 價值
目標平臺 普遍
標頭 portcls.h (包括 Portcls.h)
IRQL PASSIVE_LEVEL

另請參閱

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType