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;

Member

rcSource

Gibt ein Abschneiderechteck an, das den zu verwendenden Teil des aktiven Videosignals auswählt.

rcTarget

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

dwActiveWidth

Gibt die Breite des aktiven eingehenden Videosignals an. Beispielsweise kann der Wert für ITUR-601 auf 720 aktive Beispiele 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 Einheiten von 100 Nanosekunden an.

Hinweise

Ein Quellfilter kann anfordern, dass der Senkenfilter nur einen Abschnitt des Videos übernimmt, indem Werte bereitgestellt werden, die effektiv ein Abschneidrechteck im rcSource-Member definieren. Wenn der Senkenfilter jedoch bei der Verbindung nicht nach dem Abschneiderechteck sucht, rendert der Senkenfilter einfach das gesamte Video und ignoriert effektiv alle Ausschneideinformationen, die vom Quellfilter an den Senkenfilter übergeben werden.

Idealerweise überprüft ein Senkenfilter rcSource. Wenn der Senkenfilter 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 so festzulegen, dass das Rechteck später überprüft wird).

Das rcTarget-Element gibt das Zielrechteck für das Video an. Die meisten Quellfilter legen diesen Member auf alle Nullen fest. Ein Nachgeschalteter Filter kann anfordern, dass das Video in einem bestimmten Bereich der von ihr zur Verfügung gestellten Puffer platziert wird. In diesem Fall wird die Win32-Funktion QueryAccept mit einem nicht erlösenden Ziel aufgerufen.

Anforderungen

Anforderung	Wert
Header	ksmedia.h (include Ksmedia.h)