lFlags

Flags that determine how to set the bitmap for the overlay. You cannot combine these flags. Possible values are:

Value

Meaning

OVERLAY_COPY

[0] A copy of the overlay bitmap is inserted in the overlay list. pOverlayRaster will not be affected.

OVERLAY_NOCOPY

[1] pOverlayRaster is set into the overlay list without making a copy. You should be careful when modifying the overlay bitmap because you can modify/invalidate the entry in the overlay bitmap list. A safer way of quickly setting the data is to use OVERLAY_MOVE.

OVERLAY_MOVE

[3] pOverlayRaster is moved into the overlay list. It will also be reset, so you cannot make changes to it. This is recommended over OVERLAY_NOCOPY.