IAMTimelineComp::GetCountOfType, 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 GetCountOfType méthode récupère le nombre d’objets d’un type donné contenus dans cette composition et toutes ses pistes virtuelles, de manière récursive.

Syntaxe

HRESULT GetCountOfType(
   long                *pVal,
   long                *pValWithComps,
   TIMELINE_MAJOR_TYPE MajorType
);

Paramètres

pVal

Reçoit le nombre d’objets du type spécifié contenus dans cette composition et toutes ses pistes virtuelles, de manière récursive.

pValWithComps

Reçoit le nombre retourné dans pVal plus le nombre de compositions recherchées, y compris celle-ci.

MajorType

Membre du TIMELINE_MAJOR_TYPE type énuméré, spécifiant le type d’objet à compter.

Valeur renvoyée

Retourne S_OK en cas de réussite, ou E_POINTER autrement.

Notes

En règle générale, une application n’appelle pas cette méthode. Il est appelé par le moteur de rendu.

Si vous comptez des compositions, la valeur retournée dans pVal est zéro et la valeur retournée dans pValWithComps est le nombre de compositions. La valeur de *pValWithComps inclut la composition sur laquelle vous appelez la méthode. Par exemple, si vous appelez cette méthode sur une composition vide, *pValWithComps est égal à 1.

Les groupes ne pouvant pas résider dans des compositions, vous ne pouvez pas utiliser cette méthode pour compter les groupes. (Le nombre retourné sera toujours égal à zéro.) Pour compter les groupes, appelez la méthode IAMTimeline::GetGroupCount .

Configuration requise

Voir aussi

IAMTimelineComp, interface

Codes d’erreur et de réussite