Video- und Bildfunktionen

[Das dieser Seite zugeordnete Feature DirectShow-ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngineund Audio/Video Capture in Media Foundationersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code MediaPlayer-, IMFMediaEngine und Audio-/Videoaufnahme in Media Foundation anstelle von DirectShow-verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben werden.]

Diese Funktionen und Makros bearbeiten die DirectShow-Videoformatstrukturen.

Funktion	Beschreibung
BIT_MASKS_MATCH	Vergleicht die Farbmasken für zwei VIDEOINFO- Strukturen.
BITMASKS-	Ruft die Farbmasken aus einer VIDEOINFO--Struktur ab.
CheckVideoInfoType-	Überprüft einen Medientyp, der eine VIDEOINFOHEADER- Formatstruktur auf Fehler enthält, die Pufferüberläufe oder ganzzahlige Überläufe verursachen können.
CheckVideoInfo2Type-	Überprüft einen Medientyp, der eine VIDEOINFOHEADER2 Formatstruktur auf Fehler enthält, die Pufferüberläufe oder ganzzahlige Überläufe verursachen können.
FARBEN	Ruft die Paletteneinträge aus einer VIDEOINFO--Struktur ab.
ContainsPalette-	Bestimmt, ob eine angegebene VIDEOINFOHEADER- Struktur eine Palette enthält.
ConvertVideoInfoToVideoInfo2-	Konvertiert einen Medientyp, der VIDEOINFOHEADER- verwendet, in einen, der VIDEOINFOHEADER2
DIBSIZE-	Berechnet die Anzahl der Byte, die für eine geräteunabhängige Bitmap (DIB) erforderlich sind.
GetBitCount-	Gibt die Anzahl der Bits pro Pixel zurück, die von einem angegebenen Videountertyp verwendet werden.
GetBitmapFormatSize-	Berechnet die für eine VIDEOINFO Struktur erforderliche Größe, die eine angegebene BITMAPINFOHEADER- Struktur enthalten kann.
GetBitmapPalette-	Gibt den ersten Paletteneintrag in einer VIDEOINFOHEADER- Struktur zurück.
GetBitmapSize-	Berechnet die Anzahl der Byte, die für eine geräteunabhängige Bitmap (DIB) erforderlich sind.
GetBitmapSubtype-	Gibt den Medienuntertyp GUID- für die angegebene Bitmap zurück.
GetSubtypeName-	Ruft den lesbaren Namen eines Videountertyps ab.
GetTrueColorType-	Gibt den Medienuntertyp GUID- für eine 16-Bit-unkomprimierte RGB-Bitmap zurück.
HEADER-	Gibt die Adresse des BITMAPINFOHEADER- in einem VIDEOINFOHEADER-zurück.
MPEG1_SEQUENCE_INFO	Gibt die Adresse des Sequenzheaders innerhalb einer MPEG1VIDEOINFO Struktur zurück.
PALETTISIERTE	Überprüft, ob eine Bitmap eine Farbtiefe von 8 Bit oder weniger aufweist.
PALETTE_ENTRIES	Ruft die maximale Anzahl von Farben in der Palette einer angegebenen Bitmap ab.
RESET_MASKS	Füllt die Farbformatfelder in einer VIDEOINFO- Struktur mit Nullen.
RESET_HEADER	Füllt eine VIDEOINFOHEADER- mit Nullen aus.
RESET_PALETTE	Füllt die Paletteneinträge in einer VIDEOINFO- Struktur mit Nullen aus.
SIZE_EGA_PALETTE	Berechnet die für die Paletteneinträge in einer 4-Bit-RGB-Bitmap erforderliche Größe.
SIZE_MASKS	Berechnet die Größe der Farbmasken in einer VIDEOINFO- Struktur.
SIZE_MPEG1VIDEOINFO	Berechnet die Größe einer MPEG1VIDEOINFO Struktur, einschließlich des Sequenzheaders.
SIZE_PALETTE	berechnet die Größe der Paletteneinträge in einer VIDEOINFO- Struktur.
SIZE_PREHEADER	Berechnet den Byteoffset des bmiHeader- Felds innerhalb einer VIDEOINFOHEADER- Struktur.
SIZE_VIDEOHEADER	Berechnet die Größe der VIDEOINFOHEADER- Struktur.
TRUECOLOR-	Gibt die TRUECOLORINFO- Struktur aus einer VIDEOINFO--Struktur zurück.
ValidateBitmapInfoHeader-	Überprüft eine BITMAPINFOHEADER- Struktur auf Fehler, die Pufferüberläufe oder ganzzahlige Überläufe verursachen können.

 

Bemerkungen

Die meisten im Abschnitt beschriebenen Makros und Funktionen sind für die Bearbeitung VIDEOINFOHEADER- und VIDEOINFO- Strukturen für RGB-Bitmaps konzipiert. Verwenden Sie diese Makros mit Bedacht: Die meisten davon gehen davon aus, dass die angegebene Struktur ordnungsgemäß initialisiert wurde. Viele davon gehen auch davon aus, dass die BITMAPINFOHEADER- Struktur die Standardgröße ist; d. h. biSize == sizeof(BITMAPINFOHEADER).

Die DirectShow-Basisklassenbibliothek stellt auch die folgenden globalen Konstanten bereit, die die Standardfarbmasken für True-Color-Bitmaps definieren.

Globale Daten	Beschreibung
bits555	Array von Farbformaten für eine 16-Bit-RGB-Bitmap im 5-5-5-Format.
bits565	Array von Farbmasken für eine 16-Bit-RGB-Bitmap im 5-6-5-Format.
bits888-	Array von Farbmasken für eine 24-Bit-RGB-Bitmap.

 

Jede dieser Konstanten in einem Array von drei DWORDs mit den roten, grünen und blauen Masken in dieser Reihenfolge.