Fonctions vidéo et image
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et capture audio/vidéo dans Media Foundation au lieu de directShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
Ces fonctions et macros manipulent les structures de format vidéo DirectShow.
| Fonction | Description |
|---|---|
| BIT_MASKS_MATCH | Compare les masques de couleur pour deux structures VIDEOINFO. |
| BITMASKS | Récupère les masques de couleur d’une structure VIDEOINFO |
| CheckVideoInfoType | Vérifie un type de média qui contient un VIDEOINFOHEADER structure de format pour les erreurs pouvant entraîner des dépassements de mémoire tampon ou des dépassements d’entiers. |
| CheckVideoInfo2Type | Vérifie un type de média qui contient une structure de format VIDEOINFOHEADER2 pour les erreurs pouvant entraîner des dépassements de mémoire tampon ou des dépassements d’entiers. |
| COLORS | Récupère les entrées de palette à partir d’une structureVIDEOINFO |
| ContainsPalette | Détermine si une structure VIDEOINFOHEADER spécifiée contient une palette. |
| convertVideoInfoToVideoInfo2 | Convertit un type de média qui utilise VIDEOINFOHEADER en un qui utilise VIDEOINFOHEADER2 |
| DIBSIZE | Calcule le nombre d’octets requis par une bitmap indépendante de l’appareil (DIB). |
| GetBitCount | Retourne le nombre de bits par pixel utilisés par un sous-type vidéo spécifié. |
| GetBitmapFormatSize | Calcule la taille nécessaire pour une structureVIDEOINFOqui peut contenir une structure BITMAPINFOHEADER spécifiée. |
| GetBitmapPalette | Retourne la première entrée de palette dans une structureVIDEOINFOHEADER. |
| GetBitmapSize | Calcule le nombre d’octets requis par une bitmap indépendante de l’appareil (DIB). |
| GetBitmapSubtype | Retourne le sous-type de média GUID pour l’image bitmap spécifiée. |
| GetSubtypeName | Récupère le nom lisible par l’homme d’un sous-type vidéo. |
| GetTrueColorType | Retourne le sous-type de média GUID pour une bitmap RVB non compressée 16 bits. |
| D’EN-TÊTE | Renvoie l’adresse duBITMAPINFOHEADERdans unVIDEOINFOHEADER. |
| MPEG1_SEQUENCE_INFO | Retourne l’adresse de l’en-tête de séquence à l’intérieur d’une structure MPEG1VIDEOINFO. |
| PALETTISED | Vérifie si une bitmap a une profondeur de couleur de 8 bits ou moins. |
| PALETTE_ENTRIES | Récupère le nombre maximal de couleurs dans la palette d’une bitmap spécifiée. |
| RESET_MASKS | Remplit les champs de masque de couleur dans une structureVIDEOINFOavec des zéros. |
| RESET_HEADER | Remplit une VIDEOINFOHEADER avec des zéros. |
| RESET_PALETTE | Remplit les entrées de palette dans une structure VIDEOINFO avec des zéros. |
| SIZE_EGA_PALETTE | Calcule la taille nécessaire pour les entrées de palette dans une bitmap RVB 4 bits. |
| SIZE_MASKS | Calcule la taille des masques de couleur dans une structure VIDEOINFO. |
| SIZE_MPEG1VIDEOINFO | Calcule la taille d’une structure MPEG1VIDEOINFO, y compris l’en-tête de séquence. |
| SIZE_PALETTE | calcule la taille des entrées de palette dans une structure VIDEOINFO. |
| SIZE_PREHEADER | Calcule le décalage d’octet du champ bmiHeader dans une structure VIDEOINFOHEADER. |
| SIZE_VIDEOHEADER | Calcule la taille de la structure VIDEOINFOHEADER. |
| TRUECOLOR | Retourne la structure TRUECOLORINFO d’une structure VIDEOINFO. |
| validateBitmapInfoHeader | Vérifie une structure BITMAPINFOHEADER pour les erreurs pouvant entraîner des dépassements de mémoire tampon ou des dépassements d’entiers. |
Remarques
La plupart des macros et fonctions décrites dans la section sont conçues pour manipuler VIDEOINFOHEADER et structures VIDEOINFO pour les bitmaps RVB. Utilisez ces macros avec soin : la plupart d’entre eux supposent que la structure spécifiée a été initialisée correctement. La plupart d’entre eux supposent également que la structure BITMAPINFOHEADER est la taille standard ; c’est-à-dire biSize == sizeof(BITMAPINFOHEADER).
La bibliothèque de classes de base DirectShow fournit également les constantes globales suivantes, qui définissent les masques de couleur standard pour les bitmaps de couleur vraie.
| Données globales | Description |
|---|---|
| bits555 | Tableau de masques de couleur pour une bitmap RVB 16 bits au format 5-5-5. |
| bits565 | Tableau de masques de couleur pour une bitmap RVB 16 bits au format 5-6-5. |
| bits888 | Tableau de masques de couleur pour une bitmap RVB 24 bits. |
Chacune de ces constantes dans un tableau de trois DWORDs, contenant les masques rouges, verts et bleus, dans cet ordre.