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 對象的參考計數慣例。

規格需求

另請參閱

CM_RESOURCE_LIST

IResourceList

POOL_TYPE