class Win32_VideoController : CIM_PCVideoController
{
uint16 AcceleratorCapabilities[];
string AdapterCompatibility;
string AdapterDACType;
uint32 AdapterRAM;
uint16 Availability;
string CapabilityDescriptions[];
string Caption;
uint32 ColorTableEntries;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
uint32 CurrentBitsPerPixel;
uint32 CurrentHorizontalResolution;
uint64 CurrentNumberOfColors;
uint32 CurrentNumberOfColumns;
uint32 CurrentNumberOfRows;
uint32 CurrentRefreshRate;
uint16 CurrentScanMode;
uint32 CurrentVerticalResolution;
string Description;
string DeviceID;
uint32 DeviceSpecificPens;
uint32 DitherType;
datetime DriverDate;
string DriverVersion;
boolean ErrorCleared;
string ErrorDescription;
uint32 ICMIntent;
uint32 ICMMethod;
string InfFilename;
string InfSection;
datetime InstallDate;
string InstalledDisplayDrivers;
uint32 LastErrorCode;
uint32 MaxMemorySupported;
uint32 MaxNumberControlled;
uint32 MaxRefreshRate;
uint32 MinRefreshRate;
boolean Monochrome;
string Name;
uint16 NumberOfColorPlanes;
uint32 NumberOfVideoPages;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
uint16 ProtocolSupported;
uint32 ReservedSystemPaletteEntries;
uint32 SpecificationVersion;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
uint32 SystemPaletteEntries;
datetime TimeOfLastReset;
uint16 VideoArchitecture;
uint16 VideoMemoryType;
uint16 VideoMode;
string VideoModeDescription;
string VideoProcessor;
};
Methods
The Win32_VideoController class defines the following methods.
Method Description
Reset Not implemented. To implement this method, see the Reset method in CIM_PCVideoController for documentation.
SetPowerState Not implemented. To implement this method, see the SetPowerState method in CIM_PCVideoController for documentation.
Properties
The Win32_VideoController class has the following properties.
AcceleratorCapabilities
Data type: uint16 array
Access type: Read-only
Array of graphics and 3D capabilities of the video controller. This property is inherited from CIM_VideoController.
Value Meaning
0 Unknown
1 Other
2 Graphics Accelerator
3 3D Accelerator
AdapterCompatibility
Data type: string
Access type: Read-only
General chip set used for this controller to compare compatibilities with the system.
AdapterDACType
Data type: string
Access type: Read-only
Name or identifier of the digital-to-analog converter (DAC) chip. The character set of this property is alphanumeric.
AdapterRAM
Data type: uint32
Access type: Read-only
Qualifiers: Units(Bytes)
Memory size of the video adapter.
Example: 64000
Availability
Data type: uint16
Access type: Read-only
Availability and status of the device. Inherited from CIM_LogicalDevice.
Value Meaning
1
0x1 Other
2
0x2 Unknown
3
0x3 Running/Full Power
4
0x4 Warning
5
0x5 In Test
6
0x6 Not Applicable
7
0x7 Power Off
8
0x8 Off Line
9
0x9 Off Duty
10
0xA Degraded
11
0xB Not Installed
12
0xC Install Error
13
0xD Power Save - Unknown
The device is known to be in a power save mode, but its exact status is unknown.
14
0xE Power Save - Low Power Mode
The device is in a power save state but still functioning, and may exhibit degraded performance.
15
0xF Power Save - Standby
The device is not functioning but could be brought to full power quickly.
16
0x10 Power Cycle
17
0x11 Power Save - Warning
The device is in a warning state, though also in a power save mode.
CapabilityDescriptions
Data type: string array
Access type: Read-only
Free-form strings providing more detailed explanations for any of the video accelerator features indicated in the AcceleratorCapabilities array. Note, each entry of this array is related to the entry in the AcceleratorCapabilities array that is located at the same index. This property is inherited from CIM_VideoController.
Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen(64)
Short description (one-line string) of the object. This property is inherited from CIM_ManagedSystemElement.
ColorTableEntries
Data type: uint32
Access type: Read-only
Size of the system's color table. The device must have a color depth of no more than 8 bits per pixel; otherwise, this property is not set.
Example: 256
ConfigManagerErrorCode
Data type: uint32
Access type: Read-only
Win32 Configuration Manager error code. Value Meaning
0
0x0 Device is working properly.
1
0x1 Device is not configured correctly.
2
0x2 Windows cannot load the driver for this device.
3
0x3 Driver for this device might be corrupted, or the system may be low on memory or other resources.
4
0x4 Device is not working properly. One of its drivers or the registry might be corrupted.
5
0x5 Driver for the device requires a resource that Windows cannot manage.
6
0x6 Boot configuration for the device conflicts with other devices.
7
0x7 Cannot filter.
8
0x8 Driver loader for the device is missing.
9
0x9 Device is not working properly; the controlling firmware is incorrectly reporting the resources for the device.
10
0xA Device cannot start.
11
0xB Device failed.
12
0xC Device cannot find enough free resources to use.
13
0xD Windows cannot verify the device's resources.
14
0xE Device cannot work properly until the computer is restarted.
15
0xF Device is not working properly due to a possible re-enumeration problem.
16
0x10 Windows cannot identify all of the resources that the device uses.
17
0x11 Device is requesting an unknown resource type.
18
0x12 Device drivers need to be reinstalled.
19
0x13 Failure using the VxD loader.
20
0x14 Registry might be corrupted.
21
0x15 System failure. If changing the device driver is ineffective, see the hardware documentation. Windows is removing the device.
22
0x16 Device is disabled.
23
0x17 System failure. If changing the device driver is ineffective, see the hardware documentation.
24
0x18 Device is not present, not working properly, or does not have all of its drivers installed.
25
0x19 Windows is still setting up the device.
26
0x1A Windows is still setting up the device.
27
0x1B Device does not have valid log configuration.
28
0x1C Device drivers are not installed.
29
0x1D Device is disabled; the device firmware did not provide the required resources.
30
0x1E Device is using an IRQ resource that another device is using.
31
0x1F Device is not working properly; Windows cannot load the required device drivers.
ConfigManagerUserConfig
Data type: boolean
Access type: Read-only
If TRUE, the device is using a user-defined configuration. This property is inherited from CIM_LogicalDevice.
CreationClassName
Data type: string
Access type: Read-only
Qualifiers: MaxLen(256)
Name of the first concrete class to appear in the inheritance chain used in the creation of an instance. When used with the other key properties of the class, the property allows all instances of this class and its subclasses to be uniquely identified. This property is inherited from CIM_LogicalDevice.
CurrentBitsPerPixel
Data type: uint32
Access type: Read-only
Qualifiers: Units(Bits)
Number of bits used to display each pixel. This property is inherited from CIM_VideoController.
CurrentHorizontalResolution
Data type: uint32
Access type: Read-only
Qualifiers: Units(Pixels)
Current number of horizontal pixels. This property is inherited from CIM_VideoController.
CurrentNumberOfColors
Data type: uint64
Access type: Read-only
Number of colors supported at the current resolution. This property is inherited from CIM_VideoController.
For information on using uint64 values in scripts, see Scripting in WMI.
CurrentNumberOfColumns
Data type: uint32
Access type: Read-only
Number of columns for this video controller (if in character mode). Otherwise, enter 0. This property is inherited from CIM_VideoController.
CurrentNumberOfRows
Data type: uint32
Access type: Read-only
Number of rows for this video controller (if in character mode). Otherwise, enter 0. This property is inherited from CIM_VideoController.
CurrentRefreshRate
Data type: uint32
Access type: Read-only
Qualifiers: Units(Hertz)
Frequency at which the video controller refreshes the image for the monitor. A value of 0 indicates the default rate is being used, while 0xFFFFFFFF indicates the optimal rate is being used. This property is inherited from CIM_VideoController.
CurrentScanMode
Data type: uint16
Access type: Read-only
Current scan mode. This property is inherited from CIM_VideoController.
Value Meaning
1 Other
2 Unknown
3 Interlaced
4 Non Interlaced
CurrentVerticalResolution
Data type: uint32
Access type: Read-only
Qualifiers: Units(Pixels)
Current number of vertical pixels. This property is inherited from CIM_VideoController.
Description
Data type: string
Access type: Read-only
Description of the object. This property is inherited from CIM_ManagedSystemElement.
DeviceID
Data type: string
Access type: Read-only
Qualifiers: Key
Identifier (unique to the computer system) for this video controller. This property is inherited from CIM_LogicalDevice.
DeviceSpecificPens
Data type: uint32
Access type: Read-only
Current number of device-specific pens. A value of 0xffff means that the device does not support pens.
Example: 3
DitherType
Data type: uint32
Access type: Read-only
Dither type of the video controller. The property can be one of the predefined values, or a driver-defined value greater than or equal to 256. If line art dithering is chosen, the controller uses a dithering method that produces well-defined borders between black, white, and gray scalings. Line art dithering is not suitable for images that include continuous graduations in intensity and hue such as scanned photographs.
Value Meaning
1 No dithering
2 Dithering with a coarse brush
3 Dithering with a fine brush
4 Line art dithering
5 Device does gray scaling
DriverDate
Data type: datetime
Access type: Read-only
Last modification date and time of the currently-installed video driver.
DriverVersion
Data type: string
Access type: Read-only
Version number of the video driver.
ErrorCleared
Data type: boolean
Access type: Read-only
If TRUE, the error reported in LastErrorCode property is now cleared. This property is inherited from CIM_LogicalDevice.
ErrorDescription
Data type: string
Access type: Read-only
Free-form string supplying more information about the error recorded in LastErrorCode property, and information on any corrective actions that may be taken. This property is inherited from CIM_LogicalDevice.
ICMIntent
Data type: uint32
Access type: Read-only
Specific value of one of the three possible color-matching methods or 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 be a predefined value or a driver defined value greater than or equal to 256. Color matching based on saturation is the most appropriate choice for business graphs when dithering is not desired. Color matching based on contrast is the most appropriate choice for scanned or photographic images when dithering is desired. Color matching optimized to match the exact color requested is most appropriate for use with business logos or other images when an exact color match is desired.
Value Meaning
1 Saturation
2 Contrast
3 Exact Color
ICMMethod
Data type: uint32
Access type: Read-only
Method of handling ICM. For non-ICM applications, this property determines if ICM is enabled. For ICM applications, the system examines this property to determine how to handle ICM support. This property can be a predefined value or a driver-defined value greater than or equal to 256. The value determines which system handles image color matching.
Value Meaning
1 Disabled
2 Windows
3 Device Driver
4 Destination Device
InfFilename
Data type: string
Access type: Read-only
Path to the video adapter's .inf file.
Example: "C:\WINNT\SYSTEM32\DRIVERS"
InfSection
Data type: string
Access type: Read-only
Section of the .inf file where the Windows video information resides.
InstallDate
Data type: datetime
Access type: Read-only
Date and time the object was installed. This property does not need a value to indicate that the object is installed. This property is inherited from CIM_ManagedSystemElement.
InstalledDisplayDrivers
Data type: string
Access type: Read-only
Name of the installed display device driver.
LastErrorCode
Data type: uint32
Access type: Read-only
Last error code reported by the logical device. This property is inherited from CIM_LogicalDevice.
MaxMemorySupported
Data type: uint32
Access type: Read-only
Qualifiers: Units(Bytes)
Maximum amount of memory supported in bytes. This property is inherited from CIM_VideoController.
MaxNumberControlled
Data type: uint32
Access type: Read-only
Maximum number of directly addressable entities supportable by this controller. A value of 0 should be used if the number is unknown. This property is inherited from CIM_Controller.
MaxRefreshRate
Data type: uint32
Access type: Read-only
Qualifiers: Units(Hertz)
Maximum refresh rate of the video controller in hertz. This property is inherited from CIM_VideoController.
MinRefreshRate
Data type: uint32
Access type: Read-only
Qualifiers: Units(Hertz)
Minimum refresh rate of the video controller in hertz. This property is inherited from CIM_VideoController.
Monochrome
Data type: boolean
Access type: Read-only
If TRUE, gray scale is used to display images.
Name
Data type: string
Access type: Read-only
Label by which the object is known. When subclassed, the property can be overridden to be a key property. This property is inherited from CIM_ManagedSystemElement.
NumberOfColorPlanes
Data type: uint16
Access type: Read-only
Current number of color planes. If this value is not applicable for the current video configuration, enter 0. This property is inherited from CIM_PCVideoController.
NumberOfVideoPages
Data type: uint32
Access type: Read-only
Number of video pages supported given the current resolutions and available memory. This property is inherited from CIM_VideoController.
PNPDeviceID
Data type: string
Access type: Read-only
Windows Plug and Play device identifier of the logical device. This property is inherited from CIM_LogicalDevice.
Example: "*PNP030b"
PowerManagementCapabilities
Data type: uint16 array
Access type: Read-only
Array of the specific power-related capabilities of a logical device. This property is inherited from CIM_LogicalDevice.
Value Meaning
0
0x0 Unknown
1
0x1 Not Supported
2
0x2 Disabled
3
0x3 Enabled
The power management features are currently enabled but the exact feature set is unknown or the information is unavailable.
4
0x4 Power Saving Modes Entered Automatically
The device can change its power state based on usage or other criteria.
5
0x5 Power State Settable
The SetPowerState method is supported. This method is found on the parent CIM_LogicalDevice class and can be implemented. For more information, see Extending Your Management Capabilities.
6
0x6 Power Cycling Supported
The SetPowerState method can be invoked with the PowerState parameter set to 5 (Power Cycle).
7
0x7 Timed Power On Supported
The SetPowerState method can be invoked with the PowerState parameter set to 5 (Power Cycle) and Time set to a specific date and time, or interval, for power-on.
PowerManagementSupported
Data type: boolean
Access type: Read-only
If TRUE, the device can be power-managed (can be put into suspend mode, and so on). The property does not indicate that power management features are currently enabled, only that the logical device is capable of power management. This property is inherited from CIM_LogicalDevice.
ProtocolSupported
Data type: uint16
Access type: Read-only
Protocol used by the controller to access 'controlled' devices. This property is inherited from CIM_Controller. Values are:
Value Meaning
1
0x1 Other
2
0x2 Unknown
3
0x3 EISA
4
0x4 ISA
5
0x5 PCI
6
0x6 ATA/ATAPI
7
0x7 Flexible Diskette
8
0x8 1496
9
0x9 SCSI Parallel Interface
10
0xA SCSI Fibre Channel Protocol
11
0xB SCSI Serial Bus Protocol
12
0xC SCSI Serial Bus Protocol-2 (1394)
13
0xD SCSI Serial Storage Architecture
14
0xE VESA
15
0xF PCMCIA
16
0x10 Universal Serial Bus
17
0x11 Parallel Protocol
18
0x12 ESCON
19
0x13 Diagnostic
20
0x14 I2C
21
0x15 Power
22
0x16 HIPPI
23
0x17 MultiBus
24
0x18 VME
25
0x19 IPI
26
0x1A IEEE-488
27
0x1B RS232
28
0x1C IEEE 802.3 10BASE5
29
0x1D IEEE 802.3 10BASE2
30
0x1E IEEE 802.3 1BASE5
31
0x1F IEEE 802.3 10BROAD36
32
0x20 IEEE 802.3 100BASEVG
33
0x21 IEEE 802.5 Token-Ring
34
0x22 ANSI X3T9.5 FDDI
35
0x23 MCA
36
0x24 ESDI
37
0x25 IDE
38
0x26 CMD
39
0x27 ST506
40
0x28 DSSI
41
0x29 QIC2
42
0x2A Enhanced ATA/IDE
43
0x2B AGP
44
0x2C TWIRP (two-way infrared)
45
0x2D FIR (fast infrared)
46
0x2E SIR (serial infrared)
47
0x2F IrBus
ReservedSystemPaletteEntries
Data type: uint32
Access type: Read-only
Number of reserved entries in the system palette. The operating system may reserve entries to support standard colors for task bars and other desktop display items. This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index, and is available only if the driver is compatible with 16-bit Windows. If the system is not using a palette, ReservedSystemPaletteEntries is not set.
Example: 20
SpecificationVersion
Data type: uint32
Access type: Read-only
Version number of the initialization data specification (upon which the structure is based).
Status
Data type: string
Access type: Read-only
Qualifiers: MaxLen(10)
Current status of the object. Various operational and non-operational statuses can be defined. Operational statuses include: "OK", "Degraded", and "Pred Fail" (an element, such as a SMART-enabled hard drive, may be functioning properly but predicting a failure in the near future). Non-operational statuses include: "Error", "Starting", "Stopping", and "Service". The latter, "Service", could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is online, yet the managed element is neither "OK" nor in one of the other states. This property is inherited from CIM_ManagedSystemElement.
Values are:
"OK"
"Error"
"Degraded"
"Unknown"
"Pred Fail"
"Starting"
"Stopping"
"Service"
"Stressed"
"NonRecover"
"No Contact"
"Lost Comm"
StatusInfo
Data type: uint16
Access type: Read-only
State of the logical device. If this property does not apply to the logical device, the value 5 (Not Applicable) should be used. This property is inherited from CIM_LogicalDevice.
Value Meaning
1 Other
2 Unknown
3 Enabled
4 Disabled
5 Not Applicable
SystemCreationClassName
Data type: string
Access type: Read-only
Value of the scoping computer's CreationClassName property. This property is inherited from CIM_LogicalDevice.
SystemName
Data type: string
Access type: Read-only
Name of the scoping system. This property is inherited from CIM_LogicalDevice.
SystemPaletteEntries
Data type: uint32
Access type: Read-only
Current number of color index entries in the system palette. This index is valid only if the device driver sets the RC_PALETTE bit in the RASTERCAPS index, and is available only if the driver is compatible with 16-bit Windows. If the system is not using a palette, SystemPaletteEntries is not set.
Example: 20
TimeOfLastReset
Data type: datetime
Access type: Read-only
Date and time this controller was last reset. This could mean the controller was powered down, or reinitialized. This property is inherited from CIM_Controller.
VideoArchitecture
Data type: uint16
Access type: Read-only
Type of video architecture. This property is inherited from CIM_PCVideoController.
Value Meaning
1 Other
2 Unknown
3 CGA
4 EGA
5 VGA
6 SVGA
7 MDA
8 HGC
9 MCGA
10 8514A
11 XGA
12 Linear Frame Buffer
160 PC-98
VideoMemoryType
Data type: uint16
Access type: Read-only
Type of video memory. This property is inherited from CIM_VideoController.
Value Meaning
1 Other
2 Unknown
3 VRAM
4 DRAM
5 SRAM
6 WRAM
7 EDO RAM
8 Burst Synchronous DRAM
9 Pipelined Burst SRAM
10 CDRAM
11 3DRAM
12 SDRAM
13 SGRAM
VideoMode
Data type: uint16
Access type: Read-only
Current video mode. This property is inherited from CIM_PCVideoController.
VideoModeDescription
Data type: string
Access type: Read-only
Current resolution, color, and scan mode settings of the video controller.
Example: "1024 x 768 x 256 colors"
VideoProcessor
Data type: string
Access type: Read-only
Free-form string describing the video processor. This property is inherited from CIM_VideoController.
Remarks
The Win32_VideoController class is derived from CIM_PCVideoController.
Example Code
For script examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.
For C++ example code, see WMI C++ Application Examples.
Requirements
Client Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0 SP4 and later.
Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0 SP4 and later.
MOF Declared in Cimwin32.mof.
DLL Requires Cimwin32.dll.
Namespace Defined in \root\cimv2.
