PcNewResourceList-Funktion (portcls.h)
Die PcNewResourceList-Funktion erstellt und initialisiert eine Ressourcenliste.
Syntax
PORTCLASSAPI NTSTATUS PcNewResourceList(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PCM_RESOURCE_LIST TranslatedResources,
[in] PCM_RESOURCE_LIST UntranslatedResources
);
Parameter
[out] OutResourceList
Ausgabezeiger für das von dieser Funktion erstellte Ressourcenlistenobjekt. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene Zeigervariable, in die die Funktion den Zeiger auf das IResourceList-Objekt ausgibt. Geben Sie einen gültigen Zeigerwert ohne NULL für diesen Parameter an.
[in, optional] OuterUnknown
Zeiger auf die IUnknown-Schnittstelle eines Objekts, das das Ressourcenlistenobjekt aggregieren muss. Legen Sie diesen Parameter auf NULL fest, sofern keine Aggregation erforderlich ist.
[in] PoolType
Gibt den Typ des Pools an, aus dem das Objekt zugeordnet werden soll. Dies ist ein POOL_TYPE Enumerationswert.
[in] TranslatedResources
Zeiger auf eine von WDM bereitgestellte Ressourcenliste für übersetzte Ressourcen. Die Liste ist eine Systemstruktur vom Typ CM_RESOURCE_LIST.
[in] UntranslatedResources
Zeiger auf eine von WDM bereitgestellte Ressourcenliste für nicht übersetzte Ressourcen. Die Liste ist eine Systemstruktur vom Typ CM_RESOURCE_LIST.
Rückgabewert
PcNewResourceList gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.
Hinweise
Eine Erläuterung zu übersetzten und nicht übersetzten Ressourcenlisten (oder "Rohdaten") finden Sie unter Zuordnen Bus-Relative Adressen zu virtuellen Adressen.
Die Parameter OutResourceList und OuterUnknown folgen den Referenzzählungskonventionen für COM-Objekte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Der PortCls-Systemtreiber implementiert die PcNewResourceList-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höheren Betriebssystemen. |
| Zielplattform | Universell |
| Header | portcls.h (include Portcls.h) |
| Bibliothek | Portcls.lib |
| IRQL | PASSIVE_LEVEL |