ENUMTYPEA structure (icm.h)

Contains information that defines the profile enumeration constraints.

Syntax

typedef struct tagENUMTYPEA {
  DWORD dwSize;
  DWORD dwVersion;
  DWORD dwFields;
  PCSTR pDeviceName;
  DWORD dwMediaType;
  DWORD dwDitheringMode;
  DWORD dwResolution[2];
  DWORD dwCMMType;
  DWORD dwClass;
  DWORD dwDataColorSpace;
  DWORD dwConnectionSpace;
  DWORD dwSignature;
  DWORD dwPlatform;
  DWORD dwProfileFlags;
  DWORD dwManufacturer;
  DWORD dwModel;
  DWORD dwAttributes[2];
  DWORD dwRenderingIntent;
  DWORD dwCreator;
  DWORD dwDeviceClass;
} ENUMTYPEA, *PENUMTYPEA, *LPENUMTYPEA;

Members

dwSize

The size of this structure in bytes.

dwVersion

The version number of the ENUMTYPE structure. Should be set to ENUM_TYPE_VERSION.

dwFields

Indicates which fields in this structure are being used. Can be set to any combination of the following constant values.

ET_DEVICENAME

ET_MEDIATYPE

ET_DITHERMODE

ET_RESOLUTION

ET_CMMTYPE

ET_CLASS

ET_DATACOLORSPACE

ET_CONNECTIONSPACE

ET_SIGNATURE

ET_PLATFORM

ET_PROFILEFLAGS

ET_MANUFACTURER

ET_MODEL

ET_ATTRIBUTES

ET_RENDERINGINTENT

ET_CREATOR

ET_DEVICECLASS

pDeviceName

User friendly name of the device.

dwMediaType

Indicates which type of media is associated with the profile, such as a printer or screen.

dwDitheringMode

Indicates the style of dithering that will be used when an image is displayed.

dwResolution[2]

The horizontal (x) and vertical (y) resolution in pixels of the device on which the image will be displayed. The x resolution is stored in dwResolution[0], and the y resolution is kept in dwResolution[1].

dwCMMType

The identification number of the CMM that is used in the profile. Identification numbers are registered with the ICC.

dwClass

Indicates the profile class. For a description of profile classes, see Using Device Profiles with WCS. A profile class may have any of the following values.

Profile Class Signature
Input Device Profile CLASS_SCANNER
Display Device Profile CLASS_MONITOR
Output Device Profile CLASS_PRINTER
Device Link Profile CLASS_LINK
Color Space Conversion Profile CLASS_COLORSPACE
Abstract Profile CLASS_ABSTRACT
Named Color Profile CLASS_NAMED
Color Appearance Model Profile CLASS_CAMP
Color Gamut Map Model Profile CLASS_GMMP

dwDataColorSpace

A signature value that indicates the color space in which the profile data is defined. Can be any value from the Color Space Constants.

dwConnectionSpace

A signature value that indicates the color space in which the profile connection space (PCS) is defined. Can be any of the following values.

Profile Class Signature
XYZ SPACE_XYZ
Lab SPACE_Lab

When the dwClass member is set to CLASS_LINK, the PCS is taken from the dwDataColorSpace member.

dwSignature

Reserved for internal use.

dwPlatform

The primary platform for which the profile was created. The member can be set to any of the following values.

Platform Value
Apple Computer, Inc. 'APPL'
Microsoft Corp. 'MSFT'
Silicon Graphics, Inc. 'SGI'
Sun Microsystems, Inc. 'SUNW'
Taligent 'TGNT'

dwProfileFlags

Bit flags containing hints that the CMM uses to interpret the profile data and can be set to one of the following values.

Constant Meaning
FLAG_EMBEDDEDPROFILE The profile is embedded in a bitmap file.
FLAG_DEPENDENTONDATA The profile can't be used independently of the embedded color data. Used for profiles that are embedded in bitmap files.

dwManufacturer

The identification number of the device profile manufacturer. All manufacturer identification numbers are registered with the ICC.

dwModel

The device manufacturer's device model number. All model identification numbers are registered with the ICC.

dwAttributes[2]

Attributes of profile that can be any of the following values.

Constant Meaning
ATTRIB_TRANSPARENCY Turns transparency on. If this flag is not used, the attribute is reflective by default.
ATTRIB_MATTE Turns matte display on. If this flag is not used, the attribute is glossy by default.

dwRenderingIntent

The profile rendering intent that can be set to one of the following values:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

For more information, see Rendering intents.

dwCreator

Signature of the software that created the profile. Signatures are registered with the ICC.

dwDeviceClass

Indicates the device class. A device class may have one of the following values.

Profile Class Signature
Input Device Profile CLASS_SCANNER
Display Device Profile CLASS_MONITOR
Output Device Profile CLASS_PRINTER

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header icm.h

See also