CWiauFormatConverter::ConvertToBmp-Methode (wiautil.h)

Artikel
02/27/2024

Die CWiauFormatConverter::ConvertToBmp-Methode konvertiert ein Bild in das BMP-Format.

Syntax

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

Parameter

pSource

Zeigt auf den Speicherspeicherort, der das erste Byte des Quellimages enthält.

iSourceSize

Gibt die Größe des Quellimages in Bytes an.

ppDest

Zeiger auf einen Speicherspeicherort, der die Adresse des resultierenden Bilds empfängt.

piDestSize

Zeiger auf einen Speicherspeicherort, der die Größe des resultierenden Bilds in Bytes empfängt.

pBmpImageInfo

Zeiger auf eine BMP_IMAGE_INFO-Struktur , die Informationen zum resultierenden Bild empfängt.

iSkipAmt

Optional

Gibt die Menge des zu überspringenden BMP-Headers an. Der Standardwert dieses Parameters gibt an, dass kein BMP-Header übersprungen wird.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück. Wenn die Funktion fehlschlägt, wird ein COM-Standardfehler zurückgegeben.

Hinweise

Der Aufrufer dieser Methode kann einen Ergebnispuffer in ppDest und die Größe in piDestSize übergeben.

Alternativ kann der Aufrufer ppDest im Aufruf auf NULL und piDestSize auf Null festlegen, um anzugeben, dass diese Methode den Arbeitsspeicher zuweisen soll.

Der Aufrufer ist für die Freigabe des Arbeitsspeichers mit dem Operator delete [] verantwortlich.