Partilhar via


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

O método CWiauFormatConverter::ConvertToBmp converte uma imagem no formato BMP.

Sintaxe

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

Parâmetros

pSource

Aponta para o local de memória que contém o primeiro byte da imagem de origem.

iSourceSize

Especifica o tamanho, em bytes, da imagem de origem.

ppDest

Ponteiro para um local de memória que recebe o endereço da imagem resultante.

piDestSize

Ponteiro para um local de memória que recebe o tamanho, em bytes, da imagem resultante.

pBmpImageInfo

Ponteiro para uma estrutura BMP_IMAGE_INFO que recebe informações sobre a imagem resultante.

iSkipAmt

Opcional

Especifica a quantidade do cabeçalho BMP a ser ignorada. O valor padrão desse parâmetro indica que nenhum cabeçalho BMP é ignorado.

Retornar valor

Em caso de êxito, a função retorna S_OK. Se a função falhar, ela retornará um erro COM padrão.

Comentários

O chamador desse método pode passar um buffer de resultado em ppDest e o tamanho em piDestSize.

Como alternativa, o chamador pode definir ppDest como NULL e piDestSize como zero na chamada para indicar que esse método deve alocar a memória.

O chamador é responsável por liberar a memória usando o operador delete [] .

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wiautil.h (inclua Wiautil.h, Wiamindr.h)

Confira também

BMP_IMAGE_INFO

CWiauFormatConverter

CWiauFormatConverter::IsFormatSupported

SKIP_AMOUNT