Expand Minimize

Win32_DisplayControllerConfiguration class

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

[Provider("CIMWin32")]class Win32_DisplayControllerConfiguration : CIM_Setting
{
  uint32 BitsPerPixel;
  string Caption;
  uint32 ColorPlanes;
  string Description;
  uint32 DeviceEntriesInAColorTable;
  uint32 DeviceSpecificPens;
  uint32 HorizontalResolution;
  string Name;
  sint32 RefreshRate;
  uint32 ReservedSystemPaletteEntries;
  string SettingID;
  uint32 SystemPaletteEntries;
  uint32 VerticalResolution;
  string VideoMode;
};

Members

The Win32_DisplayControllerConfiguration class has these types of members:

Properties

The Win32_DisplayControllerConfiguration class has these properties.

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

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

Short description of the CIM_Setting object. This property is inherited from CIM_Setting.

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

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

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

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

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

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: Units (Pixels) , Deprecated

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

Example: 1024

Name
Data type: string
Access type: Read-only
Qualifiers: Key, Deprecated

Name of the adapter used in this configuration.

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

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

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

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

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

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

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

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

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.

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 XP

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Computer System Hardware Classes

 

 

Show:
© 2014 Microsoft. All rights reserved.