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