Additional
information used by the engine when creating or deleting a bit map. The
only valid flag is:
CBM_INIT
When set, bit-map parameters must be returned
in pReturns. This means that before deleting the bit map, the handling routine
must translate it into one of the standard formats. The presentation driver
must then allocate two blocks of memory, one for the bit map and another
for the bit-map parameters and color translation table. The presentation
driver can use any of the standard formats. However, it must take into account
the parameters originally specified in GreDeviceCreateBitmap. The handling
routine should use the format that uses the least amount of memory without
losing any bit-map information.
When this flag is not set, bit-map data is not returned.
Other
flags are reserved and should be ignored by the handling routine.