EngCreateDeviceBitmap

HBITMAP EngCreateDeviceBitmap(

IN DHSURF dhsurf,
IN SIZEL sizl,
IN ULONG iFormatCompat
);

EngCreateDeviceBitmap requests GDI to create a handle for a device bitmap.

Parameters

dhsurf

Identifies the device bitmap being created.

sizl

Specifies the size, in pixels, of the bitmap to be created.

iFormatCompat

Specifies the compatible engine format of the device surface being created. This is used by GDI if a temporary buffer is needed to simulate a complicated drawing call. The allowable values for iFormatCompat are BMF_1BPP, BMF_4BPP, BMF_8BPP, BMF_16BPP, BMF_24BPP, and BMF_32BPP.

Return Value

The return value is a handle that identifies the bitmap if the function is successful. Otherwise, it is zero, and an error code is logged.

Comments

The storage space for the bitmap can optionally be provided by the driver. The surface should be associated by using EngAssociateSurface. The bitmap should be deleted by calling EngDeleteSurface when it is no longer needed.

See Also

EngCreateBitmap