IAMTimeline::CreateEmptyNode, 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 dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 CreateEmptyNode méthode crée un nouvel objet chronologie.

Utilisez cette méthode pour créer des objets chronologie, plutôt que la fonction CoCreateInstance, car cette méthode effectue des routines d’initialisation importantes. Chaque objet créé par cette méthode prend en charge au moins l’interface IAMTimelineObj , ainsi que d’autres interfaces spécifiques à ce type d’objet.

Syntaxe

HRESULT CreateEmptyNode(
  [out] IAMTimelineObj      **ppObj,
        TIMELINE_MAJOR_TYPE Type
);

Paramètres

ppObj [out]

Reçoit un pointeur vers l’interface IAMTimelineObj du nouvel objet.

Type

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

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

N’ajoutez pas le nouvel objet à un autre chronologie instance. Chaque objet d’une chronologie doit être créé par cette chronologie.

Si la méthode réussit, l’interface IAMTimelineObj qu’elle retourne a un nombre de références en suspens. Veillez à libérer l’interface lorsque vous avez terminé de l’utiliser.

Configuration requise

Voir aussi

IAMTimeline Interface

Codes d’erreur et de réussite