CBaseList, classe

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode CBaseList implémente une liste abtract. Le modèle de classe CGenericList , qui dérive de CBaseList, fournit la vérification des types et une interface plus simple que la classe CBaseList .

La classe CBaseList est modélisée d’après la classe CObList dans la bibliothèque MFC (Microsoft Foundation Classes). Les positions dans la liste sont représentées par une structure POSITION. L’appelant ne doit pas accéder aux membres internes de la structure POSITION ; le traiter comme un pointeur vers un nœud de liste. La position d’un objet dans la liste reste valide jusqu’à ce que l’objet soit supprimé.

La liste ne nécessite aucune prise en charge par les objets qu’elle contient. Il n’effectue aucune gestion ou copie du stockage sur les objets. Les objets peuvent se trouver dans plusieurs listes.

Environ la moitié des méthodes de cette classe agissent sur des objets uniques. Ces méthodes ont le suffixe I dans le nom de la méthode. Les autres méthodes agissent sur des listes entières. Par exemple, la méthode CBaseList::AddAfter ajoute une liste à une autre liste. Les opérations à objet unique retournent des valeurs POSITION ou NULL en cas d’échec. Les opérations de liste retournent TRUE si elles réussissent ou FALSE dans le cas contraire.

Variables de membre protégé	Description
m_Count	Nombre d’éléments dans la liste.
m_pFirst	Pointeur vers le premier nœud de la liste.
m_pLast	Pointeur vers le dernier nœud de la liste.
Méthodes protégées	Description
GetNextI	Récupère l’élément à la position spécifiée et avance la position.
GetI	Récupère l’élément à la position spécifiée.
Findi	Récupère la première position qui contient l’élément spécifié.
RemoveHeadI	Supprime le premier élément de la liste.
RemoveTailI	Supprime le dernier élément de la liste.
RemoveI	Supprime l'élément à la position spécifiée.
AddTailI	Ajoute un élément à la fin de la liste.
AddHeadI	Ajoute un élément au début de la liste.
AddAfterI	Insère un élément après la position spécifiée.
AddBeforeI	Insère un élément avant la position spécifiée.
Méthodes publiques	Description
CBaseList	Méthode du constructeur.
~ CBaseList	Méthode de destructeur.
RemoveAll	Supprime tous les nœuds de la liste.
GetHeadPositionI	Récupère la position du premier élément de la liste.
GetTailPositionI	Récupère la position du dernier élément de la liste.
GetCountI	Récupère le nombre d’éléments de la liste.
Suivant	Récupère la position suivante dans la liste.
Précédent	Récupère la position précédente dans la liste.
AddHead	Insère une autre liste au début de cette liste.
AddTail	Ajoute une autre liste à la fin de cette liste.
AddAfter	Insère une liste après la position spécifiée.
AddBefore	Insère une liste avant la position spécifiée.
MoveToTail	Fractionne la liste et ajoute la partie principale à la fin d’une autre liste.
MoveToHead	Fractionne la liste et insère la partie de queue en tête d’une autre liste.
Inverse	Inverse l’ordre de la liste.

Configuration requise

Condition requise	Valeur
En-tête	Wxlist.h (include Streams.h)
Bibliothèque	Strmbase.lib (builds de vente au détail) ; Strmbasd.lib (builds de débogage)

Voir aussi

DirectShow Base Classes