PcNewResourceSublist-Funktion (portcls.h)

  • Artikel

Die PcNewResourceSublist-Funktion erstellt und initialisiert eine leere Ressourcenliste, die von einer anderen Ressourcenliste abgeleitet wird.

Syntax

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

Parameter

[out] OutResourceList

Ausgabezeiger auf das Ressourcenlistenobjekt, das von dieser Funktion erstellt wird. Dieser Parameter verweist auf die 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 Objekt 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] ParentList

Zeiger auf die Ressourcenliste, aus der die untergeordnete Liste erstellt wird. Die Ressourcenliste verfügt über eine IResourceList-Schnittstelle .

[in] MaximumEntries

Gibt die maximale Anzahl von Einträgen an, die der Ressourcenliste hinzugefügt werden.

Rückgabewert

PcNewResourceSublist gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Hinweise

Diese Funktion erstellt eine leere Ressourcenunterliste.

Ein Adaptertreiber verwendet normalerweise die PcNewResourceSublist-Funktion in Kombination mit der IResourceList::AddEntryFromParent-Methode , um die ursprüngliche Liste der Ressourcen zu übernehmen, die er vom System empfangen hat, und diese in Unterlisten aufzuteilen, die er seinen verschiedenen Unterabteilungen zuweist.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Der PortCls-Systemtreiber implementiert die PcNewResourceSublist-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

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE