structure KS_ANALOGVIDEOINFO (ksmedia.h)

Article
02/26/2024

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 de 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 la durée moyenne par image, 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 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. Si le filtre récepteur ne prend pas en charge l’extraction d’image 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)

Partager via