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	内存	内存
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