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 物件的參考計數慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的操作系統中實作 PcNewResourceSublist 函式。 |
| 目標平台 | Universal |
| 標頭 | portcls.h (包含 Portcls.h) |
| 程式庫 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |