IAMVideoCompression ::OverrideKeyFrame, méthode (strmif.h)

[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 OverrideKeyFrame méthode indique au filtre de compresser une image particulière en tant que trame clé.

Syntaxe

HRESULT OverrideKeyFrame(
  [in] long FrameNumber
);

Paramètres

[in] FrameNumber

Spécifie le numéro de trame. La première image que le filtre fournit est numérotée zéro.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Réussite.
E_NOTIMPL	Non implémenté.

Remarques

Si le filtre prend en charge cette méthode, vous pouvez l’utiliser pour remplacer la distribution d’images clés normale pour une image particulière. Une fois que le filtre a créé une image clé, il peut réinitialiser son nombre pour déterminer quand l’image clé suivante doit se produire. Par exemple, si la fréquence d’images de clé est de 10 et qu’une application utilise cette méthode pour forcer l’image 5 comme image clé, le filtre peut attendre 10 autres images (jusqu’à l’image 15) avant de créer l’image clé suivante.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IAMVideoCompression, interface