gpi12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
GpiQueryBitmapParameters (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIBITMAPS
 
BOOL GpiQueryBitmapParameters(hbm, pbmp)
HBITMAP hbm;               /* bitmap handle                        */
PBITMAPINFOHEADER pbmp;    /* address of structure for bitmap info */
 
The GpiQueryBitmapParameters function retrieves information about the bitmap
identified by the hbm parameter. The function copies the bitmap width,
height, and number of color planes and adjacent color bits to the structure
pointed to by the pbmp parameter.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hbm        Identifies the bitmap.
 
pbmp       Points to the BITMAPINFOHEADER structure that receives the
           information for the specified bitmap.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_HBITMAP
     PMERR_INV_HPS
     PMERR_PS_BUSY
 
See Also
 
GpiCreateBitmap, GpiLoadBitmap, GpiQueryBitmapDimension, BITMAPINFOHEADER