ICImageCompress, fonction (vfw.h)
La fonction ICImageCompress compresse une image à une taille donnée. Cette fonction ne nécessite pas de fonctions d’initialisation.
Syntaxe
HANDLE VFWAPI ICImageCompress(
HIC hic,
UINT uiFlags,
LPBITMAPINFO lpbiIn,
LPVOID lpBits,
LPBITMAPINFO lpbiOut,
LONG lQuality,
LONG *plSize
);
Paramètres
hic
Poignée à un compresseur ouvert avec la fonction ICOpen . Spécifiez NULL pour que le VCM sélectionne un compresseur approprié pour le format de compression. Une application peut faire en sorte que l’utilisateur sélectionne le compresseur à l’aide de la fonction ICCompressorChoose , qui ouvre le compresseur sélectionné et retourne une poignée du compresseur dans ce paramètre.
uiFlags
Réservés au; doit être égal à zéro.
lpbiIn
Pointeur vers la structure BITMAPINFO contenant le format de données d’entrée.
lpBits
Pointeur vers les bits de données d’entrée à compresser. Les bits de données excluent les informations d’en-tête et de format.
lpbiOut
Pointeur vers la structure BITMAPINFO contenant le format de sortie compressé. Spécifiez NULL pour que le compresseur utilise un format approprié.
lQuality
Valeur de qualité utilisée par le compresseur. Les valeurs sont comprises entre 0 et 10 000.
plSize
Taille maximale souhaitée pour l’image compressée. Le compresseur peut ne pas être en mesure de compresser les données pour tenir dans cette taille. Lorsque la fonction retourne, ce paramètre pointe vers la taille de l’image compressée. Les tailles d’image sont spécifiées en octets.
Valeur retournée
Retourne un handle à une DIB compressée. Les données d’image suivent l’en-tête de format.
Remarques
Pour obtenir les informations de format à partir de la structure BITMAPINFOHEADER , utilisez la fonction GlobalLock pour verrouiller les données. Utilisez la fonction GlobalFree pour libérer la DIB lorsque vous avez terminé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vfw.h |
| Bibliothèque | Vfw32.lib |
| DLL | Msvfw32.dll |