CMGetInfo

[This is preliminary documentation and subject to change.]

The CMGetInfo function retrieves various information about the color management module (CMM).

Every CMM is required to export this function.

DWORD WINAPI CMGetInfo(
  DWORD dwInfo  
);
 

Parameters

dwInfo
Specifies what information should be retrieved. This parameter can take one of the following constant values:
Constant Significance of the function's return value
CMM_DESCRIPTION A text string that describes the color management module.
CMM_DLL_VERSION Version number of the CMM DLL.
CMM_DRIVER_LEVEL Driver compatibility information.
CMM_IDENT The CMM identification signature registered with the International Color Consortium (ICC).
CMM_LOGOICON The logo icon for this CMM.
CMM_VERSION Version of Windows supported.
CMM_WIN_VERSION Backward compatibility with Windows 95.

Return Values

If this function succeeds, the return value is a nonzero value whose significance depends on the dwInfo parameter:

dwInfo CMGetInfo returns
CMM_DESCRIPTION The resource ID of a string containing a text description of the CMM.
CMM_DLL_VERSION Version number of the CMM DLL
CMM_DRIVER_LEVEL CMS_LEVEL_1 (for compatibility ICM 1.0)
CMM_IDENT ICC registered signature of the CMM DLL
CMM_LOGOICON The logo icon resource ID.
CMM_VERSION 0x00050000
CMM_WIN_VERSION 0x00040000 (for compatibility ICM 1.0)

If the function fails, the return value is zero.

Remarks

CMMs that do not run on Windows 95 should return 0x0050000 for CMM_WIN_VERSION.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Color Management Overview, ICM 2.0 Functions