Classe CBaseList

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método CBaseList implementa uma lista abtract. O modelo de classe CGenericList , que deriva de CBaseList, fornece verificação de tipo e uma interface mais simples do que a classe CBaseList .

A classe CBaseList é modelada após a classe CObList na biblioteca MFC (Microsoft Foundation Classes). As posições dentro da lista são representadas por uma estrutura POSITION. O chamador não deve acessar os membros internos da estrutura POSITION; trate-o como um ponteiro para um nó de lista. A posição de um objeto na lista permanece válida até que o objeto seja excluído.

A lista não requer nenhum suporte dos objetos que ela contém. Ele não executa nenhum gerenciamento de armazenamento ou cópia nos objetos . Os objetos podem estar em várias listas.

Aproximadamente metade dos métodos nessa classe atuam em objetos únicos. Esses métodos têm o sufixo – I no nome do método. Os outros métodos atuam em listas inteiras. Por exemplo, o método CBaseList::AddAfter acrescenta uma lista a outra lista. As operações de objeto único retornam valores POSITION ou NULL em caso de falha. As operações de lista retornarão TRUE se tiverem êxito ou FALSE caso contrário.

Variáveis de membro protegidas	Descrição
m_Count	Número de itens na lista.
m_pFirst	Ponteiro para o primeiro nó na lista.
m_pLast	Ponteiro para o último nó na lista.
Métodos Protegidos	Descrição
GetNextI	Recupera o item na posição especificada e avança a posição.
GetI	Recupera o item na posição especificada.
FindI	Recupera a primeira posição que contém o item especificado.
RemoveHeadI	Remove o primeiro item da lista.
RemoveTailI	Remove o último item da lista.
RemoveI	Remove o item na posição especificada.
AddTailI	Adiciona um item ao final da lista.
AddHeadI	Adiciona um item à frente da lista.
AddAfterI	Insere um item após a posição especificada.
AddBeforeI	Insere um item antes da posição especificada.
Métodos públicos	Descrição
Cbaselist	Método de construtor.
~Cbaselist	Método de destruidor.
RemoveAll	Remove todos os nós da lista.
GetHeadPositionI	Recupera a posição do primeiro item na lista.
GetTailPositionI	Recupera a posição do último item da lista.
GetCountI	Recupera o número de itens na lista.
Avançar	Recupera a próxima posição na lista.
Prev	Recupera a posição anterior na lista.
Addhead	Insere outra lista na frente desta lista.
Addtail	Acrescenta outra lista ao final desta lista.
Addafter	Insere uma lista após a posição especificada.
Addbefore	Insere uma lista antes da posição especificada.
MoveToTail	Divide a lista e acrescenta a parte principal à parte final de outra lista.
MoveToHead	Divide a lista e insere a parte final no cabeçalho de outra lista.
Reverter	Inverte a ordem da lista.

Requisitos

Requisito	Valor
parâmetro	Wxlist.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

DirectShow Base Classes