The CIM_MonitorResolution class represents the relationship between horizontal and vertical resolutions and the refresh rate and scan mode for a desktop monitor. Values are specified in the video controller object.
Important: The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.
The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.
Syntax
[Abstract, UUID("{1008CCEC-7BFF-11D2-AAD2-006008C78BC7}"), AMENDMENT]
class CIM_MonitorResolution : CIM_Setting
{
string Caption;
string Description;
string SettingID;
uint32 HorizontalResolution;
uint32 MaxRefreshRate;
uint32 MinRefreshRate;
uint32 RefreshRate;
uint16 ScanMode;
uint32 VerticalResolution;
};
Members
The CIM_MonitorResolution class has these types of members:
Properties
The CIM_MonitorResolution class has these properties.
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.
Description
Data type: string
Access type: Read-only
Textual description of the current object.
This property is inherited from CIM_Setting.
HorizontalResolution
Data type: uint32
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_VideoController.CurrentHorizontalResolution"), MappingStrings ("MIF.DMTF|Monitor Resolutions|002.2"), Units ("pixels")
Monitor's horizontal resolution, in pixels.
MaxRefreshRate
Data type: uint32
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_VideoController.MaxRefreshRate"), MappingStrings ("MIF.DMTF|Monitor Resolutions|002.7"), Units ("hertz")
Monitor's maximum refresh rate, in hertz, when a range of rates is supported at the specified resolutions.
MinRefreshRate
Data type: uint32
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_VideoController.MinRefreshRate"), MappingStrings ("MIF.DMTF|Monitor Resolutions|002.6"), Units ("hertz")
Monitor's minimum refresh rate, in hertz, when a range of rates is supported at the specified resolutions.
RefreshRate
Data type: uint32
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_VideoController.CurrentRefreshRate"), MappingStrings ("MIF.DMTF|Monitor Resolutions|002.4"), Units ("hertz")
Monitor's 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
Qualifiers: ModelCorrespondence ("CIM_VideoController.CurrentScanMode"), MappingStrings ("MIF.DMTF|Monitor Resolutions|002.5")
Scan mode that the monitor uses.
Other (1)
Unknown (2)
Not Supported (3)
Non-Interlaced Operation (4)
Interlaced Operation (5)
SettingID
Data type: string
Access type: Read-only
Qualifiers: Override ("SettingID"), Key, MaxLen (256)
Serves as part of the key for the current instance.
VerticalResolution
Data type: uint32
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_VideoController.CurrentVerticalResolution"), MappingStrings ("MIF.DMTF|Monitor Resolutions|002.3"), Units ("pixels")
Monitor's vertical resolution in pixels.
Remarks
WMI does not implement this 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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Namespace | Root\CIMV2 |
| MOF | CIMWin32.mof |
| DLL | CIMWin32.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
