Win32_VideoController Class (Windows)

Win32_VideoController Class

Win32_VideoController Class

The Win32_VideoController WMI class represents the capabilities and management capacity of the video controller on a computer system running Windows. Starting with Windows Vista, properties of this class replace 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 is supported.

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

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.
SetPowerState	Not implemented. To implement this method, see the SetPowerState method in CIM_PCVideoController.

Properties

The Win32_VideoController class defines the following properties.

AcceleratorCapabilities

Data type: uint16 array
Access type: Read-only

Array of graphics and 3-D capabilities of the video controller. This property is inherited from CIM_VideoController.

Value	Meaning
0	Unknown
1	Other
2	Graphics Accelerator
3	3-D 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 or Full Power
4 (0x4)	Warning
5 (0x5)	In Test
6 (0x6)	Not Applicable
7 (0x7)	Power Off
8 (0x8)	Offline
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 must 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, this 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 more information about 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 (zero). 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 (zero). 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 (zero) 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	Noninterlaced

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 (zero) 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 (zero). 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 Designing Managed Object Format (MOF) Classes.
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.

The values are:

Value	Meaning
1 (0x1)	Other
2 (0x2)	Unknown
3 (0x3)	EISA
4 (0x4)	ISA
5 (0x5)	PCI
6 (0x6)	ATA or 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 nonoperational statuses can be defined. Operational statuses include: "OK", "Degraded", and "Pred Fail" (an element, such as a SMART-enabled hard disk drive, may be functioning properly but predicting a failure in the near future). Nonoperational 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.

The 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.

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