Share via


Win32_DisplayConfiguration class

[The Win32_DisplayConfiguration WMI class is no longer available for use as of Windows Server 2008. Instead, use the properties in the Win32_VideoController, Win32_DesktopMonitor, and CIM_VideoControllerResolution classes.]

Windows Server 2003:

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

Hardware that is not compatible with Windows Display Driver Model (WDDM) returns inaccurate property values for instances of this class.

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

[DEPRECATED, Dynamic, Provider("CIMWin32"), UUID("{8502C4E4-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
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;
};

Members

The Win32_DisplayConfiguration class has these types of members:

  • Properties

Properties

The Win32_DisplayConfiguration class has these properties.

BitsPerPel

Data type: uint32

Access type: Read-only

Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|BITSPIXEL")

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 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: DEPRECATED, key, MaxLen (260) , MappingStrings ("WMI")

Name of the display device.

DisplayFlags

Data type: uint32

Access type: Read-only

Qualifiers: DEPRECATED, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmDisplayFlags ")

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: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|VREFRESH") , Units ("hertz")

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, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmDitherType")

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
No Dithering 1
Coarse Brush 2
Fine Brush 3
Line Art 4
Greyscale 5

Grayscale

 

DriverVersion

Data type: string

Access type: Read-only

Qualifiers: DEPRECATED, MappingStrings ("Win32Registry|System\\CurrentControlSet\\Services\\Class|Ver")

Release version of the display driver.

ICMIntent

Data type: uint32

Access type: Read-only

Qualifiers: DEPRECATED, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmICMIntent")

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.

Saturation (1)

Contrast (2)

Exact Color (3)

ICMMethod

Data type: uint32

Access type: Read-only

Qualifiers: DEPRECATED, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmICMMethod ")

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.

Disabled (1)

Windows (2)

Device Driver (3)

Device (4)

LogPixels

Data type: uint32

Access type: Read-only

Qualifiers: DEPRECATED, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmLogPixels") , Units ("pixels")

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: DEPRECATED, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmPelsHeight ") , Units ("pixels")

Height of the displayable surface.

PelsWidth

Data type: uint32

Access type: Read-only

Qualifiers: DEPRECATED, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmPelsWidth ") , Units ("pixels")

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, MappingStrings ("Win32API|Printing and Print Spooler Structures|DEVMODE|dmSpecVersion")

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

Remarks

The Win32_DisplayConfiguration class is derived from CIM_Setting.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003

End of client support

None supported

End of server support

Windows Server 2003

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

CIM_Setting

Computer System Hardware Classes