PcNewResourceSublist 函式 (portcls.h)

PcNewResourceSublist 函式會建立並初始化衍生自另一個資源清單的空白資源清單。

語法

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

參數

[out] OutResourceList

輸出此函式所建立之資源清單物件的指標。 此參數指向呼叫端配置的指標變數，函式會將指標輸出至 IResourceList 物件。 為此參數指定有效的非 NULL 指標值。

[in, optional] OuterUnknown

需要匯總物件之物件的 IUnknown 介面指標。 除非需要匯總，否則請將此參數設定為 NULL。

[in] PoolType

指定要配置物件的集區類型。 這是 POOL_TYPE 列舉值。

[in] ParentList

要從中建立子清單的資源清單指標。 資源清單具有 IResourceList 介面。

[in] MaximumEntries

指定將新增至資源清單的項目數目上限。

傳回值

如果呼叫成功，PcNewResourceSublist 會傳回STATUS_SUCCESS。 否則，它會傳回適當的錯誤碼。

備註

此函式會建立空的資源子清單。

配接器驅動程式通常會使用 PcNewResourceSublist 函式搭配 IResourceList：：AddEntryFromParent 方法來取得從系統收到的原始資源清單，並將其分割成指派給其各種子目錄的子清單。

OutResourceList、OuterUnknown 和 ParentList 參數會遵循 COM 物件的參考計數慣例。

規格需求

另請參閱

IResourceList

IResourceList：：AddEntryFromParent

POOL_TYPE