Méthode IPropertySetter::CloneProps

[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 CloneProps méthode clone un ensemble de propriétés de ce setter de propriétés et les ajoute à un nouveau setter de propriétés.

Syntaxe

HRESULT CloneProps(
  [out] IPropertySetter **ppSetter,
  [in]  REFERENCE_TIME  rtStart,
  [in]  REFERENCE_TIME  rtStop
);

Paramètres

ppSetter [out]

Reçoit un pointeur vers l’interface IPropertySetter du nouvel ensemble de propriétés.

rtStart [in]

Heure de début de la plage de valeurs à cloner, en unités de 100 nanosecondes.

rtStop [in]

Réservé.

Valeur retournée

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

Notes

Seules les valeurs qui tombent après l’heure de début spécifiée sont clonées. Les heures sur les valeurs clonées sont ensuite ajustées par rapport à l’heure de début. Par exemple, si rtStart est 2000000000 (2 secondes), une valeur à l’heure 30000000 (3 secondes) est cloné avec heure 1000000000 (1 seconde). Enfin, chaque propriété cloné reçoit une valeur initiale égale à la valeur de la propriété d’origine au début (interpolée correctement si nécessaire). En effet, les données de propriété sont fractionnées à l’heure de début spécifiée.

Si la méthode réussit, l’interface IPropertySetter 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

IPropertySetter, interface

Codes d’erreur et de réussite