Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CMGetInfo function

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

Every CMM is required to export this function.

Syntax


DWORD WINAPI CMGetInfo(
   DWORD dwInfo
);

Parameters

dwInfo

Specifies what information should be retrieved. This parameter can take one of the following constant values.

 
ConstantSignificance 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 value

If this function succeeds, the return value is the same nonzero value that was passed in through the dwInfo parameter. If the function fails, the return value is zero.

Remarks

The CMGetInfo function can be called by applications directly to obtain information about the CMM. Applications should not call other CMM functions directly. To obtain CMM information, get the path to the CMM from the registry. Invoke the Windows API function GetModuleHandle and pass the file name of the CMM as the value of its parameter. Call the CMGetInfo function and pass it the constant CMM_DESCRIPTION as the value of its parameter. Call the LoadString function. Pass the module handle as the first parameter, and the return value of the CMGetInfo function as the value of the second parameter.

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h

Library

Gdi32.lib

DLL

Icm32.dll

See also

Basic Color Management Concepts
Functions

 

 

Show: