CEnumMediaTypes.Next, méthode
[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 Next méthode récupère un nombre spécifié de types de média. Cette méthode implémente la méthode IEnumMediaTypes::Next .
Syntaxe
HRESULT Next(
ULONG cMediaTypes,
AM_MEDIA_TYPE **ppMediaTypes,
ULONG *pcFetched
);
Paramètres
-
cMediaTypes
-
Nombre de types de supports à récupérer.
-
ppMediaTypes
-
Tableau de pointeurs vers AM_MEDIA_TYPE structures, de taille cPins.
-
pcFetched
-
Pointeur vers une variable qui reçoit le nombre de types de média retournés par la méthode. Peut être NULL si cMediaTypes a la valeur 1.
Valeur renvoyée
Retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
N’a pas récupéré autant de types de supports que demandé. |
|
Opération réussie. |
|
Argument non valide. |
|
Argument pointeur NULL . |
|
L’état de la broche a changé et est désormais incohérent avec l’énumérateur. |
Notes
Si la méthode réussit, le tableau spécifié par ppMediaTypes contient des pointeurs vers AM_MEDIA_TYPE structures. Le nombre de structures est égal à *pcFetched. Libérez chaque type de média en appelant la fonction DeleteMediaType .
Cette méthode appelle la méthode CBasePin::GetMediaType de l’épingle pour récupérer les types de médias.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|