KS_VIDEOINFOHEADER-Struktur (ksmedia.h)

Die KS_VIDEOINFOHEADER-Struktur beschreibt die Bitmap- und Farbinformationen für einen Videostream.

Syntax

typedef struct tagKS_VIDEOINFOHEADER {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;

Member

rcSource

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

rcTarget

Gibt ein Rechteck an, das das Zielzielvideofenster definiert.

dwBitRate

Gibt einen Wert an, der die ungefähre Datenrate des Videostreams in Bits pro Sekunde angibt.

dwBitErrorRate

Gibt einen Wert an, der die Datenfehlerrate des Videostreams in Bitfehlern pro Sekunde angibt.

AvgTimePerFrame

Gibt die durchschnittliche Zeit pro Frame in 100 Nanosekundeneinheiten an.

bmiHeader

Beschreibt eine KS_BITMAPINFOHEADER Struktur, die Farb- und Dimensionsinformationen zur Bitmap des Videobilds enthält.

Hinweise

Verwenden Sie KS_VIDEOINFOHEADER2, um einen Videostream mit Bob- oder Weave-Einstellungen zu beschreiben.

Die KS_VIDEOINFOHEADER-Struktur ist identisch mit der Microsoft DirectShow VIDEOINFOHEADER-Struktur.

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

Im Idealfall überprüft ein Senkenfilter rcSource , und 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 festzulegen, um das Rechteck später zu überprüfen).

Das rcTarget-Element gibt das Zielrechteck für das Video an. Die meisten Quellfilter legen diesen Member auf alle Nullen fest. Ein Downstreamfilter kann anfordern, dass das Video in einem bestimmten Bereich der puffert, die es bereitstellt. In diesem Fall wird die Win32-Funktion QueryAccept mit einem nicht leeren Ziel aufgerufen.

Anforderungen

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

Weitere Informationen

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2