CBaseList-Klasse

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die CBaseList-Methode implementiert eine abtract-Liste. Die CGenericList-Klassenvorlage , die von CBaseList abgeleitet ist, bietet die Typüberprüfung und eine einfachere Schnittstelle als die CBaseList-Klasse .

Die CBaseList-Klasse wird nach der CObList-Klasse in der MFC-Bibliothek (Microsoft Foundation Classes) modelliert. Positionen innerhalb der Liste werden durch eine POSITION-Struktur dargestellt. Der Aufrufer sollte nicht auf die internen Elemente der POSITION-Struktur zugreifen. behandeln sie als Zeiger auf einen Listenknoten. Die Position eines Objekts in der Liste bleibt gültig, bis das Objekt gelöscht wird.

Die Liste erfordert keine Unterstützung durch die enthaltenen Objekte. Es führt keine Speicherverwaltung oder das Kopieren der Objekte durch. Objekte können sich in mehreren Listen enthalten.

Ungefähr die Hälfte der Methoden in dieser Klasse wirken auf einzelne Objekte. Diese Methoden haben das Suffix - I im Methodennamen. Die anderen Methoden wirken auf ganze Listen. Die CBaseList::AddAfter-Methode fügt beispielsweise eine Liste an eine andere Liste an. Einzelobjektvorgänge geben POSITION-Werte oder NULL bei Einem Fehler zurück. Listenvorgänge geben TRUE zurück, wenn dies erfolgreich war, oder andernfalls FALSE .

Geschützte Membervariablen	BESCHREIBUNG
m_Count	Anzahl der Elemente in der Liste.
m_pFirst	Zeiger auf den ersten Knoten in der Liste.
m_pLast	Zeiger auf den letzten Knoten in der Liste.
Geschützte Methoden	BESCHREIBUNG
GetNextI	Ruft das Element an der angegebenen Position ab und erhöht die Position.
GetI	Ruft das Element an der angegebenen Position ab.
FindI	Ruft die erste Position ab, die das angegebene Element enthält.
RemoveHeadI	Entfernt das erste Element in der Liste.
RemoveTailI	Entfernt das letzte Element in der Liste.
RemoveI	Entfernt das Element an der angegebenen Position.
AddTailI	Fügt am Ende der Liste ein Element hinzu.
AddHeadI	Fügt ein Element an der Spitze der Liste hinzu.
AddAfterI	Fügt ein Element nach der angegebenen Position ein.
AddBeforeI	Fügt ein Element vor der angegebenen Position ein.
Öffentliche Methoden	BESCHREIBUNG
CBaseList	Konstruktormethode.
~ CBaseList	Destruktormethode.
Removeall	Entfernt alle Knoten aus der Liste.
GetHeadPositionI	Ruft die Position des ersten Elements in der Liste ab.
GetTailPositionI	Ruft die Position des letzten Elements der Liste ab.
GetCountI	Ruft die Anzahl der Elemente in der Liste ab.
Weiter	Ruft die nächste Position in der Liste ab.
Zurück	Ruft die vorherige Position in der Liste ab.
AddHead	Fügt eine weitere Liste am Anfang dieser Liste ein.
AddTail	Fügt am Ende dieser Liste eine weitere Liste an.
Addafter	Fügt eine Liste nach der angegebenen Position ein.
Addbefore	Fügt eine Liste vor der angegebenen Position ein.
MoveToTail	Teilt die Liste auf und fügt den Kopfteil an den Ende einer anderen Liste an.
MoveToHead	Teilt die Liste auf und fügt den Hinterteil am Anfang einer anderen Liste ein.
Rückwärts	Kehrt die Reihenfolge der Liste um.

Anforderungen

Anforderung	Wert
Header	Wxlist.h (include Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

DirectShow-Basisklassen