KS_ANALOGVIDEOINFO Struktur (ksmedia.h)

Die KS_ANALOGVIDEOINFO Struktur beschreibt einen analogen Videostream.

Syntax

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

Angehörige

rcSource

Gibt ein Clippingrechteck an, das den teil des zu verwendenden aktiven Videosignals auswählt.

rcTarget

Gibt ein Rechteck an, das angibt, welcher Teil des zu verwendenden Zielpuffers verwendet werden soll.

dwActiveWidth

Gibt die Breite des aktiven eingehenden Videosignals an. Beispielsweise könnte der Wert für ITUR-601 auf 720 aktive Stichproben pro Zeile festgelegt werden.

dwActiveHeight

Gibt die Höhe des aktiven eingehenden Videosignals an. Beispielsweise könnte der Wert für NTSC auf 483 festgelegt werden. Für PAL/SECAM kann der Wert auf 575 festgelegt werden.

AvgTimePerFrame

Gibt die durchschnittliche Zeit pro Frame in 100 Nanosekundeneinheiten an.

Bemerkungen

Ein Quellfilter kann anfordern, dass der Sinkfilter nur einen Abschnitt des Videos verwendet, indem Werte bereitgestellt werden, die ein Clippingrechteck im rcSource Member effektiv definieren. Wenn der Sinkfilter jedoch nicht auf das Clippingrechteck bei verbindung überprüft, rendert der Sinkfilter einfach alle Videoinhalte, wobei alle aus dem Quellfilter an den Sinkfilter übergebenen Clippinginformationen effektiv ignoriert werden.

Idealerweise überprüft ein Senkenfilter rcSource. Wenn der Sinkfilter keine Bildextraktion unterstützt und das Rechteck nicht leer ist, wird die Verbindung abgelehnt. Ein Filter sollte die Win32-Funktion SetRectEmpty- verwenden, um ein Rechteck auf alle Nullen zurückzusetzen (und IsRectEmpty- festlegen, um das Rechteck später zu überprüfen).

Das rcTarget-Element gibt das Zielrechteck für das Video an. Die meisten Quellfilter legen dieses Element auf alle Nullen fest. Ein nachgeschalteter Filter kann anfordern, dass das Video in einem bestimmten Bereich der von ihr versorgten Puffer platziert wird. In diesem Fall ruft sie die Win32-Funktion QueryAccept- mit einem nicht zu hohen Ziel auf.

Anforderungen

Anforderung	Wert
Header-	ksmedia.h (enthalten Ksmedia.h)