Méthode CWiauFormatConverter ::ConvertToBmp (wiautil.h)

Article
02/27/2024

La méthode CWiauFormatConverter ::ConvertToBmp convertit une image au format BMP.

Syntaxe

HRESULT ConvertToBmp(
  BYTE           *pSource,
  INT            iSourceSize,
  BYTE           **ppDest,
  INT            *piDestSize,
  BMP_IMAGE_INFO *pBmpImageInfo,
  SKIP_AMOUNT    iSkipAmt
);

Paramètres

pSource

Pointe vers l’emplacement de mémoire contenant le premier octet de l’image source.

iSourceSize

Spécifie la taille, en octets, de l’image source.

ppDest

Pointeur vers un emplacement de mémoire qui reçoit l’adresse de l’image résultante.

piDestSize

Pointeur vers un emplacement de mémoire qui reçoit la taille, en octets, de l’image résultante.

pBmpImageInfo

Pointeur vers une structure BMP_IMAGE_INFO qui reçoit des informations sur l’image résultante.

iSkipAmt

Facultatif

Spécifie la quantité de l’en-tête BMP à ignorer. La valeur par défaut de ce paramètre indique qu’aucun en-tête BMP n’est ignoré.

Valeur retournée

En cas de réussite, la fonction retourne S_OK. Si la fonction échoue, elle retourne une erreur COM standard.

Remarques

L’appelant de cette méthode peut passer une mémoire tampon de résultats dans ppDest et la taille dans piDestSize.

L’appelant peut également définir ppDest sur NULL et piDestSize sur zéro dans l’appel pour indiquer que cette méthode doit allouer la mémoire.

L’appelant est chargé de libérer la mémoire à l’aide de l’opérateur delete [].