Freigeben über


CImageDisplay.CheckHeaderValidity-Methode

[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.]

Die CheckHeaderValidity -Methode überprüft eine BITMAPINFOHEADER-Struktur . Diese Methode ist nur für unkomprimierte RGB-Typen nützlich, nicht für komprimierte Typen oder YUV-Typen.

Syntax

BOOL CheckHeaderValidity(
   const VIDEOINFO *pInput
);

Parameter

pInput

Zeiger auf eine VIDEOINFO-Struktur , die die BITMAPINFOHEADER-Struktur enthält.

Rückgabewert

Gibt TRUE zurück, wenn BITMAPINFOHEADER gültig ist, oder andernfalls FALSE .

Bemerkungen

Mit dieser Methode wird überprüft, ob die Bildabmessungen nicht negativ sind. Der Komprimierungstyp ist BI_RGB oder BI_BITFIELDS; die Farbtiefe und die Farbmasken sind gültig; der biPlanes-Member ist gleich 1; und die Elemente biSize und biSizeImage sind richtig. Außerdem wird ggf. auf häufige Fehler in den Paletteneinträgen überprüft.

Anforderungen

Anforderung Wert
Header
Winutil.h (Streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CImageDisplay-Klasse