IResourceList 介面 (portcls.h)
介面IResourceList提供組態資源清單的抽象概念，這是 隨插即用 管理員在啟動時指派給裝置的系統硬體資源清單。 清單中的資源可以包含插斷向量、DMA 通道、I/O 埠位址，以及總線相對記憶體位址區塊。 如需詳細資訊，請參閱 在函式驅動程式中啟動裝置。
PortCls 系統驅動程式會實作 介面， IResourceList 並將其公開給配接器驅動程式。 當 PortCls 呼叫配接器驅動程式的裝置啟動例程 (請參閱 啟動裝置) 時，它會將對象當做其中一個呼叫參數傳遞 IResourceList 。
標頭檔 portcls.h 會定義一組宏，以簡化資源清單對象的處理。 針對每種資源類型，會定義下列四個宏：
ULONG
NumberOfpluralresourcename(
void
);
PCM_PARTIAL_RESOURCE_DESCRIPTOR
FindTranslatedsingularresourcename(
ULONG Index
);
PCM_PARTIAL_RESOURCE_DESCRIPTOR
FindUntranslatedsingularresourcename(
ULONG Index
);
NTSTATUS
AddsingularresourcenameFromParent(
PRESOURCELIST Parent,
ULONG Index
);
下表顯示定義這些宏的資源類型。
| 資源類型名稱 | 單數表單表單 | 複數形式 |
|---|---|---|
| CmResourceTypePort | 連接埠 | 連接埠 |
| CmResourceTypeInterrupt | 中斷 | 中斷 |
| CmResourceTypeMemory | Memory | 記憶 |
| CmResourceTypeDma | Dma | Dmas |
| CmResourceTypeDeviceSpecific | DeviceSpecific | DeviceSpecifics |
| CmResourceTypeBusNumber | BusNumber | BusNumbers |
| CmResourceTypePrivate | 私人 | 士兵 |
| CmResourceTypeAssignedResource | AssignedResource | AssignedResources |
| CmResourceTypeSubAllocateFrom | SubAllocateFrom | SubAllocateFroms |
如需上方左側數據行中資源類型名稱的意義，請參閱 CM_PARTIAL_RESOURCE_DESCRIPTOR。
下表明確列出 portcls.h 為每個九個資源類型定義的四個宏。 每個宏右邊都是對方法的 IResourceList 對等呼叫。
| 巨集 | 對等 IResourceList 呼叫 |
|---|---|
| NumberOfPorts () | NumberOfEntriesOfType (CmResourceTypePort) |
| FindTranslatedPort (n) | FindTranslatedEntry (CmResourceTypePort， (n) ) |
| FindUntranslatedPort (n) | FindUntranslatedEntry (CmResourceTypePort， (n) ) |
| AddPortFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypePort， (n) ) |
| NumberOfInterrupts () | NumberOfEntriesOfType (CmResourceTypeInterrupt) |
| FindTranslatedInterrupt (n) | FindTranslatedEntry (CmResourceTypeInterrupt， (n) ) |
| FindUntranslatedInterrupt (n) | FindUntranslatedEntry (CmResourceTypeInterrupt， (n) ) |
| AddInterruptFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeInterrupt， (n) ) |
| NumberOfMemories () | NumberOfEntriesOfType (CmResourceTypeMemory) |
| FindTranslatedMemory (n) | FindTranslatedEntry (CmResourceTypeMemory， (n) ) |
| FindUntranslatedMemory (n) | FindUntranslatedEntry (CmResourceTypeMemory， (n) ) |
| AddMemoryFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeMemory， (n) ) |
| NumberOfDmas () | NumberOfEntriesOfType (CmResourceTypeDma) |
| FindTranslatedDma (n) | FindTranslatedEntry (CmResourceTypeDma， (n) ) |
| FindUntranslatedDma (n) | FindUntranslatedEntry (CmResourceTypeDma， (n) ) |
| AddDmaFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeDma， (n) ) |
| NumberOfDeviceSpecifics () | NumberOfEntriesOfType (CmResourceTypeDeviceSpecific) |
| FindTranslatedDeviceSpecific (n) | FindTranslatedEntry (CmResourceTypeDeviceSpecific， (n) ) |
| FindUntranslatedDeviceSpecific (n) | FindUntranslatedEntry (CmResourceTypeDeviceSpecific， (n) ) |
| AddDeviceSpecificFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeDeviceSpecific， (n) ) |
| NumberOfBusNumbers () | NumberOfEntriesOfType (CmResourceTypeBusNumber) |
| FindTranslatedBusNumber (n) | FindTranslatedEntry (CmResourceTypeBusNumber， (n) ) |
| FindUntranslatedBusNumber (n) | FindUntranslatedEntry (CmResourceTypeBusNumber， (n) ) |
| AddBusNumberFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeBusNumber， (n) ) |
| NumberOfDevicePrivates () | NumberOfEntriesOfType (CmResourceTypeDevicePrivate) |
| FindTranslatedDevicePrivate (n) | FindTranslatedEntry (CmResourceTypeDevicePrivate， (n) ) |
| FindUntranslatedDevicePrivate (n) | FindUntranslatedEntry (CmResourceTypeDevicePrivate， (n) ) |
| AddDevicePrivateFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeDevicePrivate， (n) ) |
| NumberOfAssignedResources () | NumberOfEntriesOfType (CmResourceTypeAssignedResource) |
| FindTranslatedAssignedResource (n) | FindTranslatedEntry (CmResourceTypeAssignedResource， (n) ) |
| FindUntranslatedAssignedResource (n) | FindUntranslatedEntry (CmResourceTypeAssignedResource， (n) ) |
| AddAssignedResourceFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeAssignedResource， (n) ) |
| NumberOfSubAllocateFroms () | NumberOfEntriesOfType (CmResourceTypeSubAllocateFrom) |
| FindTranslatedSubAllocateFrom (n) | FindTranslatedEntry (CmResourceTypeSubAllocateFrom， (n) ) |
| FindUntranslatedSubAllocateFrom (n) | FindUntranslatedEntry (CmResourceTypeSubAllocateFrom， (n) ) |
| AddSubAllocateFromFromParent (p，n) | AddEntryFromParent ( (p) ，CmResourceTypeSubAllocateFrom， (n) ) |
繼承
IResourceList 介面繼承自 IUnknown 介面。
方法
IResourceList 介面具有這些方法。
| IResourceList：：AddEntry AddEntry 方法會將專案新增至資源清單。 |
| IResourceList：：AddEntryFromParent AddEntryFromParent 方法會將在資源清單的父清單中找到的專案新增至資源清單。 |
| IResourceList：：FindTranslatedEntry FindTranslatedEntry 方法會傳回指定類型的翻譯項目指標，如果沒有找到這類專案，則為 NULL。 |
| IResourceList：：FindUntranslatedEntry FindUntranslatedEntry 方法會傳回指定類型的未轉譯項目指標，如果沒有找到這類指標，則為 NULL。 |
| IResourceList：：NumberOfEntries NumberOfEntries 方法會傳回資源清單中的資源項目數目。 |
| IResourceList：：NumberOfEntriesOfType NumberOfEntriesOfType 方法會傳回資源清單中指定類型的資源項目數目。 針對每個資源類型，系統會定義宏來呼叫此方法，如先前所述。 |
| IResourceList：：TranslatedList TranslatedList 方法會傳回翻譯的資源清單。 |
| IResourceList：：UntranslatedList UntranslatedList 方法會傳回未轉譯的資源清單。 |
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | portcls.h |