PcNewResourceList-Funktion (portcls.h)

Artikel
02/07/2025

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, nichtNULL- Zeigerwert für diesen Parameter an.

[in, optional] OuterUnknown

Zeiger auf die IUnknown Schnittstelle eines Objekts, das das Ressourcenlistenobjekt aggregieren muss. Wenn keine Aggregation erforderlich ist, legen Sie diesen Parameter auf NULL-fest.

[in] PoolType

Gibt den Pooltyp an, 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.

Bemerkungen

Eine Erläuterung der übersetzten und nicht übersetzten (oder "rohen") Ressourcenlisten finden Sie unter Zuordnung Bus-Relative Adressen zu virtuellen Adressen.

Die Parameter OutResourceList und OuterUnknown- folgen den Referenzzählungskonventionen für COM-Objekte.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Der PortCls-Systemtreiber implementiert die PcNewResourceList-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höher.
Zielplattform-	Universal
Header-	portcls.h (include Portcls.h)
Library	Portcls.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

CM_RESOURCE_LIST

IResourceList-

POOL_TYPE

Freigeben über