Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |