KS_VIDEOINFOHEADER structure (ksmedia.h)
La structure KS_VIDEOINFOHEADER décrit les informations bitmap et de couleur d’un flux vidéo.
Syntaxe
typedef struct tagKS_VIDEOINFOHEADER {
RECT rcSource;
RECT rcTarget;
DWORD dwBitRate;
DWORD dwBitErrorRate;
REFERENCE_TIME AvgTimePerFrame;
KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;
Membres
rcSource
Spécifie un rectangle de découpage qui sélectionne la partie du signal vidéo actif à utiliser.
rcTarget
Spécifie un rectangle qui définit la fenêtre vidéo de destination cible.
dwBitRate
Spécifie une valeur qui indique le débit de données approximatif du flux vidéo, en bits par seconde.
dwBitErrorRate
Spécifie une valeur qui indique le taux d’erreur de données du flux vidéo, en bits d’erreurs par seconde.
AvgTimePerFrame
Spécifie la durée moyenne par image, en unités de 100 nanosecondes.
bmiHeader
Décrit une structure KS_BITMAPINFOHEADER qui contient des informations de couleur et de dimension sur l’image bitmap de l’image vidéo.
Remarques
Pour décrire un flux vidéo avec des paramètres bob ou weave, utilisez KS_VIDEOINFOHEADER2.
La structure KS_VIDEOINFOHEADER est identique à la structure Microsoft DirectShow VIDEOINFOHEADER.
Un filtre source peut demander que le filtre récepteur ne prenne qu’une section de la vidéo en fournissant des valeurs qui définissent efficacement un rectangle de découpage dans le membre rcSource . Toutefois, si le filtre récepteur ne case activée pas pour le rectangle de découpage lors de la connexion, le filtre récepteur restitue simplement toute la vidéo, ignorant ainsi toutes les informations de découpage passées du filtre source au filtre récepteur.
Dans l’idéal, un filtre récepteur vérifie rcSource et si le filtre récepteur ne prend pas en charge l’extraction d’images et que le rectangle n’est pas vide, il rejette la connexion. Un filtre doit utiliser la fonction Win32 SetRectEmpty pour réinitialiser un rectangle à tous les zéros (et définir IsRectEmpty sur plus tard case activée le rectangle).
Le membre rcTarget spécifie le rectangle de destination pour la vidéo. La plupart des filtres sources définissent ce membre sur tous les zéros. Un filtre en aval peut demander que la vidéo soit placée dans une zone particulière des mémoires tampons qu’elle fournit. Dans ce cas, elle appelle la fonction Win32 QueryAccept avec une cible non vide.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ksmedia.h (incluez Ksmedia.h) |