Win32_DisplayControllerConfiguration class

Article
01/06/2021

The Win32_DisplayControllerConfiguration WMI class represents the video adapter configuration information of a computer system running Windows.

This class is obsolete. In place of this class, you should use the properties in the Win32_VideoController, Win32_DesktopMonitor, and CIM_VideoControllerResolution classes.

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("{8502C4E5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_DisplayControllerConfiguration : CIM_Setting
{
  string Caption;
  string Description;
  string SettingID;
  uint32 BitsPerPixel;
  uint32 ColorPlanes;
  uint32 DeviceEntriesInAColorTable;
  uint32 DeviceSpecificPens;
  uint32 HorizontalResolution;
  string Name;
  sint32 RefreshRate;
  uint32 ReservedSystemPaletteEntries;
  uint32 SystemPaletteEntries;
  uint32 VerticalResolution;
  string VideoMode;
};

Members

The Win32_DisplayControllerConfiguration class has these types of members:

Properties

Properties

The Win32_DisplayControllerConfiguration class has these properties.

BitsPerPixel

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|BITSPIXEL")

Either the number of bits used to represent the color in this configuration, or the bits in each pixel.

Example: 8

Caption

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

Short textual description of the current object.

This property is inherited from CIM_Setting.

ColorPlanes

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|PLANES")

Current number of color planes used in the display configuration. A color plane is another way to represent pixel colors. Instead of assigning a single RGB value to each pixel, color planes separate the graphic into each of the primary color components (red, green, blue), and stores them in their own planes. This allows for greater color depths on 8-bit and 16-bit video systems. Present graphics systems have the bitwidth large enough to store color depth information, meaning only one color plane is needed.

Example: 1

Description

Data type: string
Access type: Read-only

Textual description of the current object.

This property is inherited from CIM_Setting.

DeviceEntriesInAColorTable

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|NUMCOLORS")

Number of color indexes in a color table of a display device (if the device has a color depth of no more than 8 bits per pixel). For devices with greater color depths, -1 is returned.

Example: 256

DeviceSpecificPens

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|NUMPENS")

Current number of device-specific pens. A value of 0xFFFFFFFF means the device does not support pens. Pens are logical properties that can be assigned by the display controller to display devices, and are used to draw lines, borders of polygons, and text.

Example: 3

HorizontalResolution

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|HORZRES"), Units ("pixels")

Current number of pixels in the horizontal direction (x-axis) of the display.

Example: 1024

Name

Data type: string
Access type: Read-only
Qualifiers: DEPRECATED, key, MappingStrings ("WMI")

Name of the adapter used in this configuration.

RefreshRate

Data type: sint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|HORZRESVREFRESH"), Units ("hertz")

Refresh rate of the video adapter. A value of 0 (zero) or 1 (one) indicates a default rate is being used. A value of -1 indicates that an optimal rate is being used.

Example: 72

ReservedSystemPaletteEntries

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|NUMRESERVED")

Current number of color index entries reserved for system use. This value is only valid for display settings that use an indexed palette. Indexed palettes are not used for color depths greater than 8 bits per pixel. If the color depth is more than 8 bits per pixel, this value is set to NULL.

Example: 20

SettingID

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

Identifier by which the current object is known.

This property is inherited from CIM_Setting.

SystemPaletteEntries

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|NUMRESERVED")

Example: 20

VerticalResolution

Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32API|Device Context Functions|GetDeviceCaps|VERTRES"), Units ("pixels")

Current number of pixels in the vertical direction (y-axis) of the display.

Example: 768

VideoMode

Data type: string
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("WMI")

User-readable description of the current screen resolution and color setting of the display.

Example: "1024 768 with 256 colors"

Remarks

The Win32_DisplayControllerConfiguration class is derived from CIM_Setting.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Win32_DisplayControllerConfiguration class

Syntax

Members

Properties

Remarks

Requirements

See also

Feedback

Feedback

Additional resources