61.3.3 Detailed Description of Changes

61.3.3.1 Changed

The following set of calls were changed as indicated. These changes may require resource code changes.

AddFontResource This calls was split into AddFontResource and AddFontModule. The first call takes a filename. The second call takes a module handle. Applications that use the module handle feature of AddFontResource must now use AddFontModule.
CloseMetaFile Widen to 32 bits. Returns handle to metafile HMF, not handle.
CopyMetaFile Widen to 32 bits. Takes and returns a hMF not a HANDLE.
CreateMetaFile Widened to 32 bits. Changed Handle to HMF.
DeleteMetaFile Widened to 32 bits. Changed Handle to HMF.
DeviceCapabilities Widened to 32 bits. Rather than calling LoadLibrary/GetProcAddress, the application now supplies the driver name to the system, which in turn will call these functions.
DeviceMode Now returns a boolean. Rather than calling LoadLibrary/GetProcAddress, the application now supplies the driver name to the system, which in turn will call these functions.
EnumFonts Widened to 32 bits. Callback function must be declared APIENTRY.
EnumMetaFile Widened to 32 bits. Callback function must be declared APIENTRY.
EnumObjects Widened to 32 bits. Callback function must be declared APIENTRY.
GetDIBits Widened to 32 bits. Return value is now a boolean, not the number of scan lines returned.
GetMetaFileBits Widened to 32 bits. Call no longer returns a global memory handle. Now the application passes in a buffer to get the information. Added the nSize and lpData parameters.
GetMetaFile Widened to 32-bits. Changed HANDLE to hMF.
GetTextFace Widened to 32-bits. Permitted lpFacename to be NULL.
LineDDA Widened to 32 bits. Callback function must be declared APIENTRY.
PlayMetaFile Widened to 32-bits. Changed HANDLE to HMF
SetBrushOrg Win32 GDI will automatically track the origin of all window-managed device contexts and adjust their brushes as necessary to maintain alignment of patterns on the surface.
SetDIBits Widened to 32 bits. Allows DIB without color table.
SetDIBitsToDevice Widened to 32 bits. Allows DIB without color table.
SetMetaFileBits Widened to 32 bits. Call no longer takes a global memory handle. Now the application passes in a buffer and a size.

61.3.3.2 Compatibility Calls

The following calls are included for compatibility only. We strongly recommend applications do not make these calls but rather the replacement calls.

CreateBitmap We are discouraging applications from using the CreateBitmap calls. Applications should use CreateDIBitmap instead. CreateBitmap does exist for compatibility. It has been widen to 32 bits.
CreateBitmapIndirect The call has been widened to 32-bits. Applications should use CreateDIBitmap.
CreateDIBPatternBrush This call takes a memory handle. We recommend that applications use CreateDIBPatternBrushPt. The new call takes a pointer to the brush rather than a memory handle. This is the only difference between the two calls.
CreateDiscardableBitmap This call is mapped to CreateCompatibleBitmap inside Win32 GDI.
FloodFill This is the exactly same as ExtFloodFill with wFillType set to FLOODFILLBORDER. Applications should use ExtFloodFill.
GetBitmapBits The “bits” returned by this call are device driver specific. The bits for a device on Win32 are not guaranteed to be the same as for previous versions of Windows. Do not do a GetBitmapBits on an old version of Windows, save the bits to file, then use those bits in a SetBitmapBits in a new version of windows. Preferable, application should use GetDIBits.
SetBitmapBits Same caveats as GetBitmapBits. Preferable, applications should use SetDIBits

61.3.3.3 Deleted

The following calls were deleted from the GDI.

GetDCOrg The GDI now does automatic brush tracking. Applications do not have to realign their brushes after the DC moved. This call was used for that purpose.
GetEnvironment This calls was used by device drivers, not applications. It has been removed from the application API.
SetEnvironment This calls was used by device drivers, not applications. It has been removed from the application API.