Win32_DisplayConfiguration Class (Windows)

Win32_DisplayConfiguration Class

The Win32_DisplayConfiguration WMI class represents configuration information for the display device on a computer running on a Windows operating system.

Starting with Windows Vista, this class is obsolete. In place of this class,use the properties in the Win32_VideoController, Win32_DesktopMonitor, and CIM_VideoControllerResolution. Hardware that is not compatible with Windows Display Driver Model (WDDM) returns inaccurate property values for instances of this class.

Windows Server 2003, Windows XP, Windows 2000, and Windows NT 4.0: This class is supported.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class Win32_DisplayConfiguration : CIM_Setting
{
  uint32 BitsPerPel;
  string Caption;
  string Description;
  string DeviceName;
  uint32 DisplayFlags;
  uint32 DisplayFrequency;
  uint32 DitherType;
  string DriverVersion;
  uint32 ICMIntent;
  uint32 ICMMethod;
  uint32 LogPixels;
  uint32 PelsHeight;
  uint32 PelsWidth;
  string SettingID;
  uint32 SpecificationVersion;
};

Methods

The Win32_DisplayConfiguration class does not define any methods.

Properties

The Win32_DisplayConfiguration class defines the following properties.

BitsPerPel

Data type: uint32
Access type: Read-only
Qualifiers: Deprecated

Number of bits used to represent the color in this configuration (bits per pixel).

Example: 8

Caption

Data type: string
Access type: Read-only

Short description (one-line string) of the CIM_Setting object. This property is inherited from CIM_Setting.

Description

Data type: string
Access type: Read-only

Description of the CIM_Setting object. This property is inherited from CIM_Setting.

DeviceName

Data type: string
Access type: Read-only
Qualifiers: Key, Deprecated, MaxLen(260)

Name of the display device.

DisplayFlags

Data type: uint32
Access type: Read-only
Qualifiers: Deprecated

If TRUE, the display device is color (versus monochrome), and noninterlaced (versus interlaced), by masking its value with the DM_GRAYSCALE and DM_INTERLACED masks respectively.

DisplayFrequency

Data type: uint32
Access type: Read-only
Qualifiers: Units(Hertz), Deprecated

The vertical refresh rate for the display. The refresh rate for a monitor is the number of times the screen is redrawn per second (frequency).

DitherType

Data type: uint32
Access type: Read-only
Qualifiers: Deprecated

Dither type of the display. This property can assume predefined values of 1 to 5, or driver-defined values from 6 to 256. Line art dithering is a special dithering method that produces well-defined borders between black, white, and gray scalings. It is not suitable for images that include continuous graduations in intensity and hue (such as scanned photographs).

Value	Meaning
1	No Dithering
2	Coarse Brush
3	Fine Brush
4	Line Art
5	Grayscale

DriverVersion

Data type: string
Access type: Read-only
Qualifiers: Deprecated

Release version of the display driver.

ICMIntent

Data type: uint32
Access type: Read-only
Qualifiers: Deprecated

Value of one of the three possible color matching methods (intents) that should be used by default. This property is used primarily for non-ICM applications. ICM applications establish intents by using the ICM functions. This property can assume predefined values of 1 to 3, or driver-defined values from 4 to 256.

Value	Meaning
1	Saturation
2	Contrast
3	Exact Color

ICMMethod

Data type: uint32
Access type: Read-only
Qualifiers: Deprecated

How ICM is handled. For a non-ICM application, this property indicates if ICM is enabled or disabled. For ICM applications, the system examines this property to determine which part of the computer system handles ICM support.

Value	Meaning
1	Disabled
2	Windows
3	Device Driver
4	Device

LogPixels

Data type: uint32
Access type: Read-only
Qualifiers: Units(Pixels), Deprecated

Number of pixels per logical inch. This property is valid only with devices that work with pixels (this excludes devices such as printers).

PelsHeight

Data type: uint32
Access type: Read-only
Qualifiers: Units(Pixels), Deprecated

Height of the displayable surface.

PelsWidth

Data type: uint32
Access type: Read-only
Qualifiers: Units(Pixels), Deprecated

Width of the displayable surface.

SettingID

Data type: string
Access type: Read-only
Qualifiers: MaxLen(256)

Identifier by which the CIM_Setting object is known. This property is inherited from CIM_Setting.

SpecificationVersion

Data type: uint32
Access type: Read-only
Qualifiers: Deprecated

Version number of the initialization data for the Windows display device.

Remarks

The Win32_DisplayConfiguration class is derived from CIM_Setting.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
MOF	Cimwin32.mof
DLL	Cimwin32.dll
Namespace	\root\cimv2