Video- és képfüggvények
[A laphoz társított funkció, DirectShowegy régi funkció. MediaPlayer, IMFMediaEngineés Audio/Video Capture a Media Foundation. Ezek a funkciók Windows 10-hez és Windows 11-hez lettek optimalizálva. A Microsoft határozottan javasolja, hogy az új kód MediaPlayer, IMFMediaEngine és Audio/Video Capture eszközt használja a Media FoundationDirectShowhelyett, ha lehetséges. A Microsoft javasolja, hogy az örökölt API-kat használó meglévő kódot át kell írni az új API-k használatára, ha lehetséges.]
Ezek a függvények és makrók manipulálják a DirectShow videóformátum-struktúráit.
| Funkció | Leírás |
|---|---|
| BIT_MASKS_MATCH | Két VIDEOINFO struktúrák színmaszkjait hasonlítja össze. |
| BITMASKS | Lekéri a színmaszkokat egy VIDEOINFO struktúrából |
| CheckVideoInfoType | Egy VIDEOINFOHEADER formátumstruktúrát tartalmazó médiatípust ellenőriz olyan hibák esetén, amelyek puffertúllépéseket vagy egész szám túlcsordulásokat okozhatnak. |
| CheckVideoInfo2Type | Olyan médiatípust ellenőriz, amely VIDEOINFOHEADER2 formátumstruktúrát tartalmaz olyan hibák esetén, amelyek puffertúlcsordulásokat vagy egész számok túlcsordulását okozhatják. |
| SZÍNEK | Lekéri a palettabejegyzéseket egy VIDEOINFO struktúrából |
| ContainsPalette | Meghatározza, hogy egy megadott VIDEOINFOHEADER struktúra tartalmaz-e palettát. |
| ConvertVideoInfoToVideoInfo2 | VIDEOINFOHEADER használó médiatípust konvertál VIDEOINFOHEADER2 |
| DIBSIZE | Kiszámítja az eszközfüggetlen bitkép (DIB) által igényelt bájtok számát. |
| GetBitCount | A megadott videó altípus által képpontonként használt bitek számát adja vissza. |
| GetBitmapFormatSize | Kiszámítja egy adott BITMAPINFOHEADER struktúrát tartalmazó VIDEOINFO szerkezethez szükséges méretet. |
| GetBitmapPalette | Egy VIDEOINFOHEADER struktúrában lévő első palettabejegyzést adja vissza. |
| GetBitmapSize | Kiszámítja az eszközfüggetlen bitkép (DIB) által igényelt bájtok számát. |
| GetBitmapSubtype | A megadott bitképhez tartozó GUID média altípusát adja vissza. |
| GetSubtypeName | Lekéri egy videó altípusának olvasható nevét. |
| GetTrueColorType | Egy 16 bites tömörítetlen RGB-bitkép GUID médiaaltípusát adja vissza. |
| FEJLÉC | A BITMAPINFOHEADER címét adja vissza egy VIDEOINFOHEADER. |
| MPEG1_SEQUENCE_INFO | A sorozatfejléc címét adja vissza egy MPEG1VIDEOINFO struktúrában. |
| PALETTIZÁLT | Ellenőrzi, hogy egy bitkép színmélysége 8 bites vagy annál kisebb-e. |
| PALETTE_ENTRIES | Egy adott bitkép palettájában található színek maximális számát kéri le. |
| RESET_MASKS | Egy VIDEOINFO struktúrában kitölti a színmaszk mezőit nullákkal. |
| RESET_HEADER | Egy VIDEOINFOHEADER kitöltése nullákkal. |
| RESET_PALETTE | A VIDEOINFO struktúrában lévő palettabejegyzéseket nullákkal tölti ki. |
| SIZE_EGA_PALETTE | Kiszámítja a palettabejegyzésekhez szükséges méretet egy 4 bites RGB-bitképben. |
| SIZE_MASKS | Kiszámítja a színmaszkok méretét egy VIDEOINFO struktúrában. |
| SIZE_MPEG1VIDEOINFO | Kiszámítja egy MPEG1VIDEOINFO struktúra méretét, beleértve a sorozatfejlécet is. |
| SIZE_PALETTE | kiszámítja a VIDEOINFO struktúrában lévő palettabejegyzések méretét. |
| SIZE_PREHEADER | Kiszámítja a bmiHeader mező bájteltolódását egy VIDEOINFOHEADER struktúrán belül. |
| SIZE_VIDEOHEADER | Kiszámítja a VIDEOINFOHEADER szerkezet méretét. |
| TRUECOLOR | A TRUECOLORINFOVIDEOINFO struktúrából adja vissza. |
| ValidateBitmapInfoHeader | Ellenőrzi a BITMAPINFOHEADER szerkezetét olyan hibák esetén, amelyek puffertúlcsordulásokat vagy egész számok túlcsordulását okozhatják. |
Megjegyzések
A szakaszban leírt makrók és függvények többsége VIDEOINFOHEADER és VIDEOINFO struktúrák RGB bitképekhez való manipulálására szolgál. Körültekintően használja ezeket a makrókat: A legtöbben feltételezik, hogy a megadott struktúra inicializálása megfelelően történt. Sokan azt is feltételezik, hogy a BITMAPINFOHEADER szerkezet a standard méret; vagyis biSize == sizeof(BITMAPINFOHEADER).
A DirectShow alaposztály-kódtára a következő globális állandókat is biztosítja, amelyek meghatározzák a normál színmaszkokat a valódi színű bitképekhez.
| Globális adatok | Leírás |
|---|---|
| bit555 | Színmaszkok tömbje 16 bites RGB-bitképhez 5-5-5 formátumban. |
| bitek565 | Színmaszkok tömbje 16 bites RGB-bitképhez 5-6-5 formátumban. |
| bitek888 | Színmaszkok tömbje egy 24 bites RGB-bitképhez. |
Ezek az állandók három DWORDtömbben találhatók, amelyek a piros, zöld és kék maszkokat tartalmazzák ebben a sorrendben.