IImagingFactory::CreateBitmapFromImage (Compact 2013)

3/26/2014

This feature is being deprecated for this release. Refer to this component: Windows Imaging Component.

This method creates an in-memory bitmap image object from another image object.

Syntax

HRESULT CreateBitmapFromImage(
  IImage* image,
  OPTIONAL UINT width,
  OPTIONAL UINT height,
  OPTIONAL PixelFormatID pixelFormat,
  InterpolationHint hints,
  IBitmapImage** bitmap
);

Parameters

• image
  [in] A pointer to an IImage interface containing the original image data.

• width
  [in] A UINT value that specifies the width, in pixels, of the new bitmap image.

  Set this value to 0 create a new bitmap image that is the same height as the source image.

• height
  [in] A UINT value that specifies the height, in pixels, of the new bitmap image.

  Set this value to 0 create a new bitmap image that is the same width as the source image.

• pixelFormat
  [in] A PixelFormatID value that specifies the numerical format of the pixels in the image. For more information, see PixelFormat Values.

  Set this value to PixelFormatDontCare to create a new bitmap image that has the same pixel format as the source image.

• hints
  [in] An InterpolationHint enumeration value that specifies the interpolation technique that this method should use when resizing the bitmap.

• bitmap
  [out] A pointer to the resulting IBitmapImage interface pointer.

  Use the interface to access the bitmap image created by this method.

Return Value

If successful, this method returns S_OK.

This method may return E_POINTER if it fails.

Remarks

This method is convenient for converting a bitmap image object of one pixel format into another object of a different pixel format.

Requirements

See Also

Reference

IImagingFactory
IImage
PixelFormat Values
InterpolationHint
IBitmapImage