Video- und Bildfunktionen

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

Diese Funktionen und Makros bearbeiten die DirectShow-Videoformatstrukturen.

Funktion	BESCHREIBUNG
BIT_MASKS_MATCH	Vergleicht die Farbmasken für zwei VIDEOINFO-Strukturen .
BITMASKEN	Ruft die Farbmasken aus einer VIDEOINFO-Struktur ab.
CheckVideoInfoType	Überprüft einen Medientyp, der eine VIDEOINFOHEADER-Formatstruktur enthält, auf Fehler, die zu Pufferüberläufen oder Ganzzahlüberläufen führen können.
CheckVideoInfo2Type	Überprüft einen Medientyp, der eine VIDEOINFOHEADER2-Formatstruktur enthält, auf Fehler, die zu Pufferüberläufen oder Ganzzahlüberläufen führen 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 Medientyp, der VIDEOINFOHEADER2 verwendet.
DIBSIZE	Berechnet die Anzahl von Bytes, die für eine geräteunabhängige Bitmap (DEVICE-Independent Bitmap, DIB) erforderlich sind.
GetBitCount	Gibt die Anzahl der Bits pro Pixel zurück, die von einem angegebenen Videountertyp verwendet werden.
GetBitmapFormatSize	Berechnet die größe, die für eine VIDEOINFO-Struktur erforderlich ist, die eine angegebene BITMAPINFOHEADER-Struktur enthalten kann.
GetBitmapPalette	Gibt den ersten Paletteneintrag in einer VIDEOINFOHEADER-Struktur zurück.
GetBitmapSize	Berechnet die Anzahl von Bytes, die für eine geräteunabhängige Bitmap (DEVICE-Independent Bitmap, DIB) erforderlich sind.
GetBitmapSubtype	Gibt die 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-nicht komprimierte RGB-Bitmap zurück.
HEADER	Gibt die Adresse von BITMAPINFOHEADER in einem VIDEOINFOHEADER zurück.
MPEG1_SEQUENCE_INFO	Gibt die Adresse des Sequenzheaders in einer MPEG1VIDEOINFO-Struktur zurück.
PALETTIERT	Ü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 Farbmaskenfelder in einer VIDEOINFO-Struktur mit Nullen aus.
RESET_HEADER	Füllt einen VIDEOINFOHEADER mit Nullen aus.
RESET_PALETTE	Füllt die Paletteneinträge in einer VIDEOINFO-Struktur mit Nullen aus.
SIZE_EGA_PALETTE	Berechnet die größe, die für die Paletteneinträge in einer 4-Bit-RGB-Bitmap erforderlich ist.
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 zu Pufferüberläufen oder Ganzzahlüberläufen führen können.

 

Bemerkungen

Die meisten im Abschnitt beschriebenen Makros und Funktionen sind für die Bearbeitung von VIDEOINFOHEADER - und VIDEOINFO-Strukturen für RGB-Bitmaps konzipiert. Verwenden Sie diese Makros mit Sorgfalt: Die meisten von ihnen gehen davon aus, dass die angegebene Struktur ordnungsgemäß initialisiert wurde. Viele davon gehen auch davon aus, dass die BITMAPINFOHEADER-Struktur die Standardgröße hat. 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 Farbmasken 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 DWORD-S, die die roten, grünen und blauen Masken in dieser Reihenfolge enthält.