Metodo CWiauFormatConverter::ConvertToBmp (wiautil.h)

Articolo
02/27/2024

Il metodo CWiauFormatConverter::ConvertToBmp converte un'immagine in formato BMP.

Sintassi

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

Parametri

pSource

Punta alla posizione di memoria contenente il primo byte dell'immagine di origine.

iSourceSize

Specifica le dimensioni, in byte, dell'immagine di origine.

ppDest

Puntatore a una posizione di memoria che riceve l'indirizzo dell'immagine risultante.

piDestSize

Puntatore a una posizione di memoria che riceve le dimensioni, in byte, dell'immagine risultante.

pBmpImageInfo

Puntatore a una struttura BMP_IMAGE_INFO che riceve informazioni sull'immagine risultante.

iSkipAmt

Facoltativo

Specifica la quantità di intestazione BMP da ignorare. Il valore predefinito di questo parametro indica che nessuna intestazione BMP viene ignorata.

Valore restituito

In caso di esito positivo, la funzione restituisce S_OK. Se la funzione ha esito negativo, restituisce un errore COM standard.

Commenti

Il chiamante di questo metodo può passare un buffer dei risultati in ppDest e le dimensioni in piDestSize.

In alternativa, il chiamante può impostare ppDest su NULL e piDestSize su zero nella chiamata per indicare che questo metodo deve allocare la memoria.

Il chiamante è responsabile della liberazione della memoria tramite l'operatore delete [].