PcNewResourceList 函式 (portcls.h)
PcNewResourceList 函式會建立並初始化資源清單。
語法
PORTCLASSAPI NTSTATUS PcNewResourceList(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PCM_RESOURCE_LIST TranslatedResources,
[in] PCM_RESOURCE_LIST UntranslatedResources
);
參數
[out] OutResourceList
此函式所建立之資源清單對象的輸出指標。 此參數指向呼叫端配置的指標變數,函式會將指標輸出至 IResourceList 物件。 為此參數指定有效的非NULL 指標值。
[in, optional] OuterUnknown
需要匯總資源清單物件的 IUnknown 介面指標。 除非需要匯總,否則請將此參數設定為 NULL。
[in] PoolType
指定要從中配置物件的集區類型。 這是 POOL_TYPE 列舉值。
[in] TranslatedResources
轉譯資源之 WDM 提供的資源清單指標。 此清單是類型為 CM_RESOURCE_LIST的系統結構。
[in] UntranslatedResources
未傳輸之資源的 WDM 提供資源清單的指標。 此清單是類型為 CM_RESOURCE_LIST的系統結構。
傳回值
PcNewResourceList 如果呼叫成功,就會傳回STATUS_SUCCESS。 否則,它會傳回適當的錯誤碼。
言論
如需已翻譯和未轉譯(或「原始」)資源清單的討論,請參閱 將位址對應至虛擬位址 Bus-Relative。
OutResourceList 和 OuterUnknown 參數遵循 COM 物件的 參考計數慣例。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的作系統中實作 PcNewResourceList 函式。 |
目標平臺 | 普遍 |
標頭 | portcls.h (包括 Portcls.h) |
連結庫 | Portcls.lib |
IRQL | PASSIVE_LEVEL |