Gdi::BitBlt_I (Windows Embedded CE 6.0)

1/6/2010

This method transfers pixels from a specified source rectangle to a specified destination rectangle, altering the pixels according to the selected raster operation (ROP) code.

Syntax

static WINGDIAPI BOOL WINAPI BitBlt_I(
  HDC hdcDest, 
  int nXDest, 
  int nYDest, 
  int nWidth, 
  int nHeight, 
  HDC hdcSrc, 
  int nXSrc, 
  int nYSrc, 
  DWORD dwRop
);

Parameters

• hdcDest
  [in] Handle to the destination device context.

• nXDest
  [in] Integer that specifies the logical x-coordinate of the upper left corner of the destination rectangle.

• nYDest
  [in] Integer that specifies the logical y-coordinate of the upper left corner of the destination rectangle.

• nWidth
  [in] Integer that specifies the logical width of the source and destination rectangles.

• nHeight
  [in] Integer that specifies the logical height of the source and the destination rectangles.

• hdcSrc
  [in] Handle to the source device context.

• nXSrc
  [in] Integer that specifies the logical x-coordinate of the upper left corner of the source rectangle.

• nYSrc
  [in] Integer that specifies the logical y-coordinate of the upper left corner of the source rectangle.

• dwRop
  [in] DWORD that specifies a raster-operation code. These codes define how the color data for the source rectangle is to be combined with the color data for the destination rectangle to achieve the final color.

  The following table shows some common raster operation codes.

  Value	Description
  BLACKNESS	Fills the destination rectangle using the color associated with index 0 in the physical palette. This color is black for the default physical palette.
  DSTINVERT	Inverts the destination rectangle.
  MERGECOPY	Merges the colors of the source rectangle with the specified pattern by using the Boolean AND operator.
  MERGEPAINT	Merges the colors of the inverted source rectangle with the colors of the destination rectangle by using the Boolean OR operator.
  NOTSRCCOPY	Copies the inverted source rectangle to the destination.
  NOTSRCERASE	Combines the colors of the source and destination rectangles by using the Boolean OR operator and then inverts the resultant color.
  PATCOPY	Copies the specified pattern into the destination bitmap.
  PATINVERT	Combines the colors of the specified pattern with the colors of the destination rectangle by using the Boolean XOR operator.
  PATPAINT	Combines the colors of the pattern with the colors of the inverted source rectangle by using the Boolean OR operator. The result of this operation is combined with the colors of the destination rectangle by using the Boolean OR operator.
  SRCAND	Combines the colors of the source and destination rectangles by using the Boolean AND operator.
  SRCCOPY	Copies the source rectangle directly to the destination rectangle.
  SRCERASE	Combines the inverted colors of the destination rectangle with the colors of the source rectangle by using the Boolean AND operator.
  SRCINVERT	Combines the colors of the source and destination rectangles by using the Boolean XOR operator.
  SRCPAINT	Combines the colors of the source and destination rectangles by using the Boolean OR operator.
  WHITENESS	Fills the destination rectangle using the color associated with index number 1 in the physical palette. This color is white for the default physical palette.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

This method is an internal version of the BitBlt function.

If a rotation or shear transformation is in effect in the source device context, Gdi::BitBlt_I returns an error.

If other transformations exist in the source device context and a matching transformation is not in effect in the destination device context, the rectangle in the destination device context is stretched, compressed, or rotated as necessary.

If the color formats of the source and destination device contexts do not match, Gdi::BitBlt_I converts the color format of the source to match the destination format.

Not all devices support Gdi::BitBlt_I. For more information, see the RC_BITBLT raster capability entry in the Gdi::GetDeviceCaps_I method, as well as the Gdi::MaskBlt_I and Gdi::StretchBlt_I methods.

Gdi::BitBlt_I returns an error if the source and destination device contexts represent different devices.

The dwRop parameter can be any ROP3.

Requirements

See Also

Reference

Gdi
BitBlt
Gdi::GetDeviceCaps_I
Gdi::MaskBlt_I
Gdi::StretchBlt_I