structure KS_VIDEOINFO (ksmedia.h)

La structure KS_VIDEOINFO décrit les informations bitmap et de couleur d’un flux vidéo.

Syntaxe

typedef struct tagKS_VIDEOINFO {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
  union {
    KS_RGBQUAD       bmiColors[KS_iPALETTE_COLORS];
    DWORD            dwBitMasks[KS_iMASK_COLORS];
    KS_TRUECOLORINFO TrueColorInfo;
  };
} KS_VIDEOINFO, *PKS_VIDEOINFO;

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 indique la partie de la mémoire tampon cible à utiliser.

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.

bmiColors[KS_iPALETTE_COLORS]

Tableau de structures KS_RGBQUAD qui spécifie la palette de couleurs de la vidéo. Chaque structure représente une couleur unique, qui est une combinaison d’intensités rouges, vertes et bleues.

dwBitMasks[KS_iMASK_COLORS]

Tableau de valeurs DWORD qui spécifient des masques de bits de couleur vraie.

TrueColorInfo

KS_TRUECOLORINFO structure qui contient à la fois une palette de couleurs et un tableau de masques de couleur.

Remarques

Cette structure ne doit pas être utilisée, sauf si le membre biSize du membre KS_BITMAPINFOHEADER est défini sur sizeof(KS_BITMAPINFOHEADER).

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 IsRectEmpty à 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)

Voir aussi

KS_BITMAPINFOHEADER

KS_RGBQUAD

KS_TRUECOLORINFO