PcNewResourceList-Funktion (portcls.h)

  • Artikel

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

Weitere Informationen

CM_RESOURCE_LIST

IResourceList

POOL_TYPE