IAMVideoCompression ::get_KeyFrameRate 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 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 get_KeyFrameRate méthode récupère la fréquence d’images de clé actuelle.

Syntaxe

HRESULT get_KeyFrameRate(
  [out] long *pKeyFrameRate
);

Paramètres

[out] pKeyFrameRate

Pointeur vers une variable qui reçoit la fréquence d’images de clé actuelle. Si la valeur est négative, le filtre utilise la fréquence d’images par défaut. Si la valeur est égale à zéro, seule la première image est une image clé.

Valeur retournée

Retourne une valeur HRESULT .

Remarques

La fréquence d’images clés est le nombre d’images par image clé. Par exemple, si le taux est de 15, une image clé se produit toutes les 15 images.

Pour déterminer si le filtre prend en charge cette méthode, appelez la méthode IAMVideoCompression ::GetInfo et case activée pour l’indicateur CompressionCaps_CanKeyFrame dans le paramètre pCapabilities. La méthode GetInfo retourne également la fréquence d’images par défaut.

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

IAMVideoCompression ::p ut_KeyFrameRate