IResourceList-Schnittstelle (portcls.h)

Die IResourceList Schnittstelle stellt eine Abstraktion einer Konfigurationsressourcenliste bereit. Dabei handelt es sich um eine Liste der Systemhardwareressourcen, die der Plug & Play-Manager einem Gerät zum Startzeitpunkt zuweist. Die Ressourcen in der Liste können Interruptvektoren, DMA-Kanäle, E/A-Portadressen und Blöcke mit busrelativen Speicheradressen enthalten. Weitere Informationen finden Sie unter Starten eines Geräts in einem Funktionstreiber.

Der PortCls-Systemtreiber implementiert die IResourceList Schnittstelle und macht sie für Adaptertreiber verfügbar. Wenn PortCls die Gerätestartroutine eines Adaptertreibers aufruft (siehe Starten eines Geräts), übergibt es ein IResourceList -Objekt als einen der Aufrufparameter.

Die Headerdatei portcls.h definiert einen Satz von Makros, um die Behandlung von Ressourcenlistenobjekten zu vereinfachen. Für jeden Ressourcentyp werden die folgenden vier Makros definiert:

ULONG
  NumberOfpluralresourcename(
    void
 ); 

PCM_PARTIAL_RESOURCE_DESCRIPTOR
  FindTranslatedsingularresourcename(
    ULONG  Index
    );

PCM_PARTIAL_RESOURCE_DESCRIPTOR
  FindUntranslatedsingularresourcename(
    ULONG  Index
    );

NTSTATUS
  AddsingularresourcenameFromParent(
    PRESOURCELIST  Parent,
    ULONG  Index
    );

In der folgenden Tabelle sind die Ressourcentypen aufgeführt, für die diese Makros definiert sind.

Name des Ressourcentyps	Singular Form	Pluralform
CmResourceTypePort	Port	Ports
CmResourceTypeInterrupt	Interrupt	Interrupts
CmResourceTypeMemory	Arbeitsspeicher	Erinnerungen
CmResourceTypeDma	Dma	Dmas
CmResourceTypeDeviceSpecific	Devicespecific	DeviceSpecifics
CmResourceTypeBusNumber	BusNumber	BusNumbers
CmResourceTypePrivate	Privat	Privat
CmResourceTypeAssignedResource	AssignedResource	AssignedResources
CmResourceTypeSubAllocateFrom	SubAllocateFrom	SubAllocateFroms

 

Die Bedeutung der Ressourcentypnamen in der linken Spalte oben finden Sie unter CM_PARTIAL_RESOURCE_DESCRIPTOR.

In der folgenden Tabelle sind explizit die vier Makros aufgeführt, die portcls.h für jeden der neun Ressourcentypen definiert. Rechts neben jedem Makro befindet sich der äquivalente Aufruf einer IResourceList -Methode.

Makro	Gleichwertiger IResourceList-Aufruf
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))

Vererbung

Die IResourceList-Schnittstelle erbt von der IUnknown-Schnittstelle.

Methoden

Die IResourceList-Schnittstelle verfügt über diese Methoden.

IResourceList::AddEntry Die AddEntry-Methode fügt einer Ressourcenliste einen Eintrag hinzu.
IResourceList::AddEntryFromParent Die AddEntryFromParent-Methode fügt einer Ressourcenliste einen Eintrag in der übergeordneten Liste der Ressourcenliste hinzu.
IResourceList::FindTranslatedEntry Die FindTranslatedEntry-Methode gibt einen Zeiger auf einen übersetzten Eintrag des angegebenen Typs oder NULL zurück, wenn kein solcher Eintrag gefunden wurde.
IResourceList::FindUntranslatedEntry Die FindUntranslatedEntry-Methode gibt einen Zeiger auf einen nicht übersetzten Eintrag des angegebenen Typs oder NULL zurück, wenn kein solcher Zeiger gefunden wird.
IResourceList::NumberOfEntries Die NumberOfEntries-Methode gibt die Anzahl der Ressourcenelemente in der Ressourcenliste zurück.
IResourceList::NumberOfEntriesOfType Die NumberOfEntriesOfType-Methode gibt die Anzahl der Ressourcenelemente eines bestimmten Typs in der Ressourcenliste zurück. Für jeden Ressourcentyp wird ein Makro definiert, um diese Methode wie zuvor beschrieben aufzurufen.
IResourceList::TranslatedList Die TranslatedList-Methode gibt die Liste der übersetzten Ressourcen zurück.
IResourceList::UntranslatedList Die UntranslatedList-Methode gibt die Liste der nicht übersetzten Ressourcen zurück.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portcls.h