KS_VIDEOINFO-Struktur (ksmedia.h)

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

Syntax

typedef struct tagKS_VIDEOINFO {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
  union {
    KS_RGBQUAD       bmiColors[KS_iPALETTE_COLORS];
    DWORD            dwBitMasks[KS_iMASK_COLORS];
    KS_TRUECOLORINFO TrueColorInfo;
  };
} KS_VIDEOINFO, *PKS_VIDEOINFO;

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.

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 Einheiten von 100 Nanosekunden an.

bmiHeader

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

bmiColors[KS_iPALETTE_COLORS]

Array von KS_RGBQUAD Strukturen, die die Farbpalette des Videos angibt. Jede Struktur stellt eine einzelne Farbe dar, bei der es sich um eine Kombination aus roter, grüner und blauer Intensität handelt.

dwBitMasks[KS_iMASK_COLORS]

Array von DWORD-Werten, die True-Color-Bitmasken angeben.

TrueColorInfo

KS_TRUECOLORINFO Struktur, die sowohl eine Farbpalette als auch ein Array von Farbbitmasken enthält.

Hinweise

Diese Struktur darf nur verwendet werden, wenn das biSize-Element des KS_BITMAPINFOHEADER-Members auf sizeof(KS_BITMAPINFOHEADER) festgelegt ist.

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.

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 , 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 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)

Weitere Informationen

KS_BITMAPINFOHEADER

KS_RGBQUAD

KS_TRUECOLORINFO