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 |
|---|---|
|
Réussite. |
|
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 |