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;
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.
dwBitRate
Gibt einen Wert an, der die ungefähre Datenrate des Videodatenstroms in Bits pro Sekunde angibt.
dwBitErrorRate
Gibt einen Wert an, der die Datenfehlerrate des Videodatenstroms 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 Bemaßungsinformationen zur Videobildbitmap 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.
Bemerkungen
Diese Struktur darf nur verwendet werden, wenn das Mitglied des KS_BITMAPINFOHEADER Elements auf Größe(KS_BITMAPINFOHEADER) festgelegt ist.
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.
Im Idealfall überprüft ein Senkenfilter rcSource- und 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, 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) |