structure KS_ANALOGVIDEOINFO (ksmedia.h)

La structure KS_ANALOGVIDEOINFO décrit un flux vidéo analogique.

Syntaxe

typedef struct tagKS_AnalogVideoInfo {
  RECT           rcSource;
  RECT           rcTarget;
  DWORD          dwActiveWidth;
  DWORD          dwActiveHeight;
  REFERENCE_TIME AvgTimePerFrame;
} KS_ANALOGVIDEOINFO, *PKS_ANALOGVIDEOINFO;

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.

dwActiveWidth

Spécifie la largeur du signal vidéo entrant actif. Par exemple, la valeur d’ITUR-601 peut être définie sur 720 échantillons actifs par ligne.

dwActiveHeight

Spécifie la hauteur du signal vidéo entrant actif. Par exemple, la valeur de NTSC peut être définie sur 483. Pour PAL/SECAM, la valeur peut être définie sur 575.

AvgTimePerFrame

Spécifie le temps moyen par frame, en unités de 100 nanosecondes.

Remarques

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 rcSource membre. Toutefois, si le filtre récepteur ne vérifie pas le rectangle de découpage sur la connexion, le filtre récepteur affiche simplement toutes les vidéos, ignorant efficacement les informations de découpage transmises du filtre source au filtre récepteur.

Idéalement, un filtre récepteur vérifie rcSource. 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 sur tous les zéros (et définir IsRectEmpty pour vérifier ultérieurement le rectangle).

Le rcTarget membre spécifie le rectangle de destination de 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, il appelle la fonction Win32 QueryAccept avec une cible vide.

Exigences

Exigence	Valeur
d’en-tête	ksmedia.h (include Ksmedia.h)