CBaseList (clase)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método CBaseList implementa una lista abtract. La plantilla de clase CGenericList , que deriva de CBaseList, proporciona comprobación de tipos y una interfaz más sencilla que la clase CBaseList .

La clase CBaseList se modela después de la clase CObList en la biblioteca Microsoft Foundation Classes (MFC). Las posiciones dentro de la lista se representan mediante una estructura POSITION. El autor de la llamada no debe tener acceso a los miembros internos de la estructura POSITION; tratarlo como puntero a un nodo de lista. La posición de un objeto de la lista permanece válida hasta que se elimina el objeto.

La lista no requiere ninguna compatibilidad con los objetos que contiene. No realiza ninguna administración de almacenamiento ni copia en los objetos . Los objetos pueden estar en varias listas.

Aproximadamente la mitad de los métodos de esta clase actúan en objetos individuales. Estos métodos tienen el sufijo - I en el nombre del método. Los demás métodos actúan en listas completas. Por ejemplo, el método CBaseList::AddAfter anexa una lista a otra lista. Las operaciones de objeto único devuelven valores POSITION o NULL en caso de error. Las operaciones de lista devuelven TRUE si se ejecuta correctamente o FALSE de lo contrario.

Variables miembro protegidas	Descripción
m_Count	Número de elementos de la lista.
m_pFirst	Puntero al primer nodo de la lista.
m_pLast	Puntero al último nodo de la lista.
Métodos protegidos	Descripción
GetNextI	Recupera el elemento en la posición especificada y avanza la posición.
GetI	Recupera el elemento en la posición especificada.
FindI	Recupera la primera posición que contiene el elemento especificado.
RemoveHeadI	Quita el primer elemento de la lista.
RemoveTailI	Quita el último elemento de la lista.
RemoveI	Quita el elemento de en la posición especificada.
AddTailI	Agrega un elemento al final de la lista.
AddHeadI	Agrega un elemento al principio de la lista.
AddAfterI	Inserta un elemento después de la posición especificada.
AddBeforeI	Inserta un elemento antes de la posición especificada.
Métodos públicos	Descripción
CBaseList	Método constructor.
~ CBaseList	Método de destructor.
RemoveAll	Quita todos los nodos de la lista.
GetHeadPositionI	Recupera la posición del primer elemento de la lista.
GetTailPositionI	Recupera la posición del último elemento de la lista.
GetCountI	Recupera el número de elementos de la lista.
Next	Recupera la siguiente posición de la lista.
Prev	Recupera la posición anterior de la lista.
AddHead	Inserta otra lista al principio de esta lista.
AddTail	Anexa otra lista al final de esta lista.
AddAfter	Inserta una lista después de la posición especificada.
AddBefore	Inserta una lista antes de la posición especificada.
MoveToTail	Divide la lista y anexa la parte principal a la cola de otra lista.
MoveToHead	Divide la lista e inserta la parte final en la cabeza de otra lista.
Marcha atrás	Invierte el orden de la lista.

Requisitos

Requisito	Value
Encabezado	Wxlist.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

Clases base directShow