Classe CBaseList

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo CBaseList implementa un elenco abtract. Il modello di classe CGenericList , che deriva da CBaseList, fornisce il controllo dei tipi e un'interfaccia più semplice rispetto alla classe CBaseList .

La classe CBaseList viene modellata dopo la classe CObList nella libreria MFC (Microsoft Foundation Classes). Le posizioni all'interno dell'elenco sono rappresentate da una struttura POSITION. Il chiamante non deve accedere ai membri interni della struttura POSITION; considerarlo come puntatore a un nodo elenco. La posizione di un oggetto nell'elenco rimane valida fino a quando l'oggetto non viene eliminato.

L'elenco non richiede alcun supporto per gli oggetti in esso contenuti. Non esegue alcuna gestione dell'archiviazione o copia sugli oggetti. Gli oggetti possono trovarsi in più elenchi.

Circa la metà dei metodi di questa classe agisce su singoli oggetti. Questi metodi hanno il suffisso - I nel nome del metodo. Gli altri metodi agiscono su interi elenchi. Ad esempio, il metodo CBaseList::AddAfter aggiunge un elenco a un altro elenco. Le operazioni a oggetto singolo restituiscono valori POSITION o NULL in caso di errore. Le operazioni di elenco restituiscono TRUE se l'operazione riesce o FALSE in caso contrario.

Variabili membro protette	Descrizione
m_Count	Numero di elementi nell'elenco.
m_pFirst	Puntatore al primo nodo nell'elenco.
m_pLast	Puntatore all'ultimo nodo nell'elenco.
Metodi protetti	Descrizione
GetNextI	Recupera l'elemento nella posizione specificata e sposta in avanti la posizione.
GetI	Recupera l'elemento nella posizione specificata.
FindI	Recupera la prima posizione che contiene l'elemento specificato.
RemoveHeadI	Rimuove il primo elemento nell'elenco.
RemoveTailI	Rimuove l'ultimo elemento nell'elenco.
RemoveI	Rimuove l'elemento nella posizione specificata.
AddTailI	Aggiunge un elemento alla fine dell'elenco.
AddHeadI	Aggiunge un elemento alla parte anteriore dell'elenco.
AddAfterI	Inserisce un elemento dopo la posizione specificata.
AddBeforeI	Inserisce un elemento prima della posizione specificata.
Metodi pubblici	Descrizione
CBaseList	Metodo del costruttore.
~ CBaseList	Metodo distruttore.
RemoveAll	Rimuove tutti i nodi dall'elenco.
GetHeadPositionI	Recupera la posizione del primo elemento nell'elenco.
GetTailPositionI	Recupera la posizione dell'ultimo elemento dell'elenco.
GetCountI	Recupera il numero di elementi nell'elenco.
Avanti	Recupera la posizione successiva nell'elenco.
Prev	Recupera la posizione precedente nell'elenco.
AddHead	Inserisce un altro elenco all'inizio dell'elenco.
AddTail	Aggiunge un altro elenco alla fine di questo elenco.
AddAfter	Inserisce un elenco dopo la posizione specificata.
AddBefore	Inserisce un elenco prima della posizione specificata.
MoveToTail	Divide l'elenco e aggiunge la parte head alla parte finale di un altro elenco.
MoveToHead	Suddivide l'elenco e inserisce la parte finale all'inizio di un altro elenco.
Invertire	Inverte l'ordine dell'elenco.

Requisiti

Requisito	Valore
Intestazione	Wxlist.h (include Streams.h)
Libreria	Strmbase.lib (build retail); Strmbasd.lib (build di debug)

Vedi anche

Classi di base DirectShow