CIM_VideoControllerResolution Class (Windows)

CIM_VideoControllerResolution Class

The CIM_VideoControllerResolution class represents the various video modes that a video controller can support. Video modes are defined by the possible horizontal and vertical resolutions, refresh rate, scan mode, and number of color settings supported by a controller. The actual resolutions in use are the values specified in the CIM_VideoController object. Starting with Windows Vista, properties of this class replace the data in Win32_DisplayConfiguration.

Starting with Windows Vista, 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 returns accurate data.

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

Syntax

class CIM_VideoControllerResolution
{
  string Caption;
  string Description;
  uint32 HorizontalResolution;
  uint32 MaxRefreshRate;
  uint32 MinRefreshRate;
  uint64 NumberOfColors;
  uint32 RefreshRate;
  uint16 ScanMode;
  string SettingID;
  uint32 VerticalResolution;
};

Methods

The CIM_VideoControllerResolution class does not define any methods.

Properties

The CIM_VideoControllerResolution class defines the following properties.

Caption

Data type: string
Access type: Read-only

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

Description

Data type: string
Access type: Read-only

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

HorizontalResolution

Data type: uint32
Access type: Read-only

Horizontal resolution, in pixels.

MaxRefreshRate

Data type: uint32
Access type: Read-only

Maximum refresh rate when a range of rates is supported at the specified resolutions, in hertz.

MinRefreshRate

Data type: uint32
Access type: Read-only

Minimum refresh rate when a range of rates is supported at the specified resolutions, in hertz.

NumberOfColors

Data type: uint64
Access type: Read-only

Number of colors supported at the current resolution.

For more information about using uint64 values in scripts, see Scripting in WMI.

RefreshRate

Data type: uint32
Access type: Read-only

Refresh rate, in hertz. If a range of rates is supported, use the MinRefreshRate and MaxRefreshRate properties, and set this property to 0.

ScanMode

Data type: uint16
Access type: Read-only

Scan mode at which the controller operates.

Value	Meaning
1	Other
2	Unknown
3	Not supported
4	Noninterlaced operation
5	Interlaced operation

SettingID

Data type: string
Access type: Read-only

Part of the key for an instance of this class. This property is inherited from CIM_Setting.

VerticalResolution

Data type: uint32
Access type: Read-only

Controller's vertical resolution, in pixels.

Remarks

WMI implements the CIM_VideoControllerResolution class. The CIM_VideoControllerResolution class is a dynamic class.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

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

Send comments about this topic to Microsoft

Build date: 11/3/2009