Home Reference WMI Reference root CIMV2 Win32_VideoController
 

Win32_VideoController

The Win32_VideoController class represents the capabilities and management capacity of the video controller on a Win32 computer system.

Examples: Video adapter manufacturer, chipset version, display resolution, and number of colors.

Quick Start

Properties

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

AcceleratorCapabilities

Data type UInt16

An array of integers indicating the graphics and 3D capabilities of the video controller.

AdapterCompatibility

Data type String

The AdapterCompatibility properties contains the general chip set used for this controller in order to compare compatibilities with the system

AdapterDACType

Data type String

The AdapterDACType property contains a string of the Digital-to-Analog converter (DAC) chip name or ID.

Character Set: Alphanumeric

AdapterRAM

Data type UInt32

The AdapterRAM property indicates the memory size of the video adapter.

Example: 64000

Availability

Data type UInt16

The availability and status of the device. For example, the Availability property indicates that the device is running and has full power (value=3), or is in a warning (4), test (5), degraded (10) or power save state (values 13-15 and 17). Regarding the power saving states, these are defined as follows: Value 13 (“Power Save – Unknown”) indicates that the device is known to be in a power save mode, but its exact status in this mode is unknown; 14 (“Power Save – Low Power Mode”) indicates that the device is in a power save state but still functioning, and may exhibit degraded performance; 15 (“Power Save – Standby”) describes that the device is not functioning but could be brought to full power ‘quickly’; and value 17 (“Power Save – Warning”) indicates that the device is in a warning state, though also in a power save mode.

$Availability_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Running/Full Power'
    4='Warning'
    5='In Test'
    6='Not Applicable'
    7='Power Off'
    8='Off Line'
    9='Off Duty'
   10='Degraded'
   11='Not Installed'
   12='Install Error'
   13='Power Save - Unknown'
   14='Power Save - Low Power Mode'
   15='Power Save - Standby'
   16='Power Cycle'
   17='Power Save - Warning'
   18='Paused'
   19='Not Ready'
   20='Not Configured'
   21='Quiesced'
}

CapabilityDescriptions

Data type String

An array of free-form strings providing more detailed explanations for any of the video accelerator features indicated in the Capabilities array. Note, each entry of this array is related to the entry in the Capabilities array that is located at the same index.

Caption

Data type String

The Caption property is a short textual description (one-line string) of the object.

ColorTableEntries

Data type UInt32

The ColorTableEntries property indicates the size of the system’s color table, if the device has a color depth of no more than 8 bits per pixel, null otherwise.

Example: 256

ConfigManagerErrorCode

Data type UInt32

Indicates the Win32 Configuration Manager error code. The following values may be returned:

0 This device is working properly.

1 This device is not configured correctly.

2 Windows cannot load the driver for this device.

3 The driver for this device might be corrupted, or your system may be running low on memory or other resources.

4 This device is not working properly. One of its drivers or your registry might be corrupted.

5 The driver for this device needs a resource that Windows cannot manage.

6 The boot configuration for this device conflicts with other devices.

7 Cannot filter.

8 The driver loader for the device is missing.

9 This device is not working properly because the controlling firmware is reporting the resources for the device incorrectly.

10 This device cannot start.

11 This device failed.

12 This device cannot find enough free resources that it can use.

13 Windows cannot verify this device’s resources.

14 This device cannot work properly until you restart your computer.

15 This device is not working properly because there is probably a re-enumeration problem.

16 Windows cannot identify all the resources this device uses.

17 This device is asking for an unknown resource type.

18 Reinstall the drivers for this device.

19 Your registry might be corrupted.

20 Failure using the VxD loader.

21 System failure: Try changing the driver for this device. If that does not work, see your hardware documentation. Windows is removing this device.

22 This device is disabled.

23 System failure: Try changing the driver for this device. If that doesn’t work, see your hardware documentation.

24 This device is not present, is not working properly, or does not have all its drivers installed.

25 Windows is still setting up this device.

26 Windows is still setting up this device.

27 This device does not have valid log configuration.

28 The drivers for this device are not installed.

29 This device is disabled because the firmware of the device did not give it the required resources.

30 This device is using an Interrupt Request (IRQ) resource that another device is using.

31 This device is not working properly because Windows cannot load the drivers required for this device.

$ConfigManagerErrorCode_ReturnValue = 
@{
    0='This device is working properly.'
    1='This device is not configured correctly.'
    2='Windows cannot load the driver for this device.'
    3='The driver for this device might be corrupted    4= or your system may be running low on memory or other resources.'

    5='This device is not working properly. One of its drivers or your registry might be corrupted.'
    6='The driver for this device needs a resource that Windows cannot manage.'
    7='The boot configuration for this device conflicts with other devices.'
    8='Cannot filter.'
    9='The driver loader for the device is missing.'
   10='This device is not working properly because the controlling firmware is reporting the resources for the device incorrectly.'
   11='This device cannot start.'
   12='This device failed.'
   13='This device cannot find enough free resources that it can use.'
   14='Windows cannot verify this device's resources.'    15='This device cannot work properly until you restart your computer.'    16='This device is not working properly because there is probably a re-enumeration problem.'    17='Windows cannot identify all the resources this device uses.'    18='This device is asking for an unknown resource type.'    19='Reinstall the drivers for this device.'    20='Failure using the VxD loader.'    21='Your registry might be corrupted.'    22='System failure: Try changing the driver for this device. If that does not work
   23= see your hardware documentation. Windows is removing this device.'    24='This device is disabled.'    25='System failure: Try changing the driver for this device. If that doesn't work    26= see your hardware documentation.'
   27='This device is not present   28= is not working properly
   29= or does not have all its drivers installed.'

   30='Windows is still setting up this device.'
   31='Windows is still setting up this device.'
}

ConfigManagerUserConfig

Data type Boolean

Indicates whether the device is using a user-defined configuration.

CreationClassName

Data type String

CreationClassName indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.

CurrentBitsPerPixel

Data type UInt32

The number of bits used to display each pixel.

CurrentHorizontalResolution

Data type UInt32

Current number of horizontal pixels.

CurrentNumberOfColors

Data type UInt64

Number of colors supported at the current resolutions.

CurrentNumberOfColumns

Data type UInt32

If in character mode, number of columns for this video controller. Otherwise, enter 0.

CurrentNumberOfRows

Data type UInt32

If in character mode, number of rows for this video controller. Otherwise, enter 0.

CurrentRefreshRate

Data type UInt32

The CurrentRefreshRate property specifies the 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.

CurrentScanMode

Data type UInt16

Current scan mode. “Interlaced” (value=3) or “Non Interlaced” (4) can be defined using this property.

$CurrentScanMode_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Interlaced'
    4='Non Interlaced'
}

CurrentVerticalResolution

Data type UInt32

Current number of vertical pixels.

Description

Data type String

The Description property provides a textual description of the object.

DeviceID

Data type String

The DeviceID property contains a identifier (unique to the computer system) for this video controller.

DeviceSpecificPens

Data type UInt32

The DeviceSpecificPens property indicates the current number of device-specific pens. 0xffff means the device does not support pens.

Example: 3

DitherType

Data type UInt32

The DitherType property indicates the dither type of the video controller. The property can be one of the following predefined values, or a driver-defined value greater than or equal to 256: Value Meaning :-1 – No dithering. 2 – Dithering with a coarse brush. 3 – Dithering with a fine brush. 4 – Line art dithering; a special dithering method that produces well defined borders between black, white, and gray scalings. It is not suitable for images that include continuous graduations in intensity and hue such as scanned photographs. 5 – Device does grayscaling.

$DitherType_ReturnValue = 
@{
    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

The DriverDate property indicates the last modification date and time of the currently-installed video driver.

DriverVersion

Data type String

The DriverVersion property indicates the version number of the video driver.

ErrorCleared

Data type Boolean

ErrorCleared is a boolean property indicating that the error reported in LastErrorCode property is now cleared.

ErrorDescription

Data type String

ErrorDescription is a free-form string supplying more information about the error recorded in LastErrorCode property, and information on any corrective actions that may be taken.

ICMIntent

Data type UInt32

The ICMIntent ( Image Color Matching Intent ) property indicates the specific value of one of the three possible color matching methods, (or intents) that should be used by default. This property is primarily for non-ICM applications. ICM applications establish intents by using the ICM functions. This property can be one of the following predefined values, or a driver defined value greater than or equal to 256.Value Meaning :-1 – Color matching should optimize for color saturation. This value is the most appropriate choice for business graphs when dithering is not desired. 2 – Color matching should optimize for color contrast. This value is the most appropriate choice for scanned or photographic images when dithering is desired. 3 – Color matching should optimize to match the exact color requested. This value is most appropriate for use with business logos or other images when an exact color match is required.

$ICMIntent_ReturnValue = 
@{
    1='Saturation'
    2='Contrast'
    3='Exact Color'
}

ICMMethod

Data type UInt32

The ICMMethod ( Image Color Matching Method ) property specifies how ICM is handled. For a non-ICM application, this property shows howICM is enabled. For ICM applications, the system examines this member to determine how to handle ICM support. This property can be one of the following predefined values, or a driver-defined value greater than or equal to 256.Value Meaning :-1 – Specifies that ICM is disabled. 2 – Specifies that ICM is handled by Windows. 3 – Specifies that ICM is handled by the device driver. 4 – Specifies that ICM is handled by the destination device.

$ICMMethod_ReturnValue = 
@{
    1='Disabled'
    2='Windows'
    3='Device Driver'
    4='Destination Device'
}

InfFilename

Data type String

The InfFilename property indicates the path to the video adapter’s .INF file.

Example: C:\WINNT\SYSTEM32\DRIVERS

InfSection

Data type String

The InfSection property indicates the section of the .INF file where the Win32 video information resides.

InstallDate

Data type DateTime

The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

InstalledDisplayDrivers

Data type String

The InstalledDisplayDrivers property indicates the name of the installed display device driver.

LastErrorCode

Data type UInt32

LastErrorCode captures the last error code reported by the logical device.

MaxMemorySupported

Data type UInt32

Maximum amount of memory supported in bytes.

MaxNumberControlled

Data type UInt32

Maximum number of directly addressable entities supported by this Controller. A value of 0 should be used if the number is unknown or unlimited.

MaxRefreshRate

Data type UInt32

Maximum refresh rate of the video controller in hertz.

MinRefreshRate

Data type UInt32

Minimum refresh rate of the video controller in hertz.

Monochrome

Data type Boolean

The Monochrome property indicates whether gray scale or color is used to display images.

Name

Data type String

The Name property defines the label by which the object is known. When subclassed, the Name property can be overridden to be a Key property.

NumberOfColorPlanes

Data type UInt16

Current number of color planes. If this value is not applicable for the current video configuration, enter 0.

NumberOfVideoPages

Data type UInt32

Number of video pages supported given the current resolutions and available memory.

PNPDeviceID

Data type String

Indicates the Win32 Plug and Play device ID of the logical device. Example: *PNP030b

PowerManagementCapabilities

Data type UInt16

Indicates the specific power-related capabilities of the logical device. The array values, 0=”Unknown”, 1=”Not Supported” and 2=”Disabled” are self-explanatory. The value, 3=”Enabled” indicates that the power management features are currently enabled but the exact feature set is unknown or the information is unavailable. “Power Saving Modes Entered Automatically” (4) describes that a device can change its power state based on usage or other criteria. “Power State Settable” (5) indicates that the SetPowerState method is supported. “Power Cycling Supported” (6) indicates that the SetPowerState method can be invoked with the PowerState input variable set to 5 (“Power Cycle”). “Timed Power On Supported” (7) indicates that the SetPowerState method can be invoked with the PowerState input variable set to 5 (“Power Cycle”) and the Time parameter set to a specific date and time, or interval, for power-on.

PowerManagementSupported

Data type Boolean

Boolean indicating that the Device can be power managed – ie, put into a power save state. This boolean does not indicate that power management features are currently enabled, or if enabled, what features are supported. Refer to the PowerManagementCapabilities array for this information. If this boolean is $false, the integer value 1, for the string, “Not Supported”, should be the only entry in the PowerManagementCapabilities array.

ProtocolSupported

Data type UInt16

The protocol used by the controller to access ‘controlled’ devices.

$ProtocolSupported_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='EISA'
    4='ISA'
    5='PCI'
    6='ATA/ATAPI'
    7='Flexible Diskette'
    8='1496'
    9='SCSI Parallel Interface'
   10='SCSI Fibre Channel Protocol'
   11='SCSI Serial Bus Protocol'
   12='SCSI Serial Bus Protocol-2 (1394)'
   13='SCSI Serial Storage Architecture'
   14='VESA'
   15='PCMCIA'
   16='Universal Serial Bus'
   17='Parallel Protocol'
   18='ESCON'
   19='Diagnostic'
   20='I2C'
   21='Power'
   22='HIPPI'
   23='MultiBus'
   24='VME'
   25='IPI'
   26='IEEE-488'
   27='RS232'
   28='IEEE 802.3 10BASE5'
   29='IEEE 802.3 10BASE2'
   30='IEEE 802.3 1BASE5'
   31='IEEE 802.3 10BROAD36'
   32='IEEE 802.3 100BASEVG'
   33='IEEE 802.5 Token-Ring'
   34='ANSI X3T9.5 FDDI'
   35='MCA'
   36='ESDI'
   37='IDE'
   38='CMD'
   39='ST506'
   40='DSSI'
   41='QIC2'
   42='Enhanced ATA/IDE'
   43='AGP'
   44='TWIRP (two-way infrared)'
   45='FIR (fast infrared)'
   46='SIR (serial infrared)'
   47='IrBus'
}

ReservedSystemPaletteEntries

Data type UInt32

The ReservedSystemPaletteEntries property indicates the current number of reserved entries in a system’s color table. The operating system may reserve entries to support standard colors for task bars and other desktop display items. If the system is not using a palette, then ReservedSystemPaletteEntries is null.

Example: 24.

SpecificationVersion

Data type UInt32

The SpecificationVersion property indicates the version number of the initialization data specification (upon which the structure is based).

Status

Data type String

The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are “OK”, “Degraded” and “Pred Fail”. “Pred Fail” indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are “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 on-line, yet the managed element is neither “OK” nor in one of the other states.

'OK','Error','Degraded','Unknown','Pred Fail','Starting','Stopping','Service','Stressed','NonRecover','No Contact','Lost Comm'

StatusInfo

Data type UInt16

StatusInfo is a string indicating whether the logical device is in an enabled (value = 3), disabled (value = 4) or some other (1) or unknown (2) state. If this property does not apply to the logical device, the value, 5 (“Not Applicable”), should be used.

$StatusInfo_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Enabled'
    4='Disabled'
    5='Not Applicable'
}

SystemCreationClassName

Data type String

The scoping System’s CreationClassName.

SystemName

Data type String

The scoping System’s Name.

SystemPaletteEntries

Data type UInt32

The SystemPaletteEntries property indicates the current number of entries in a system’s color table. If the system is not using a palette then SystemPaletteEntries is null.

Example: 256

TimeOfLastReset

Data type DateTime

The TimeOfLastReset property indicates the date and time this controller was last reset. This could mean the controller was powered down, or reinitialized.

VideoArchitecture

Data type UInt16

The video architecture. For example, VGA (value=5) or PC-98 (160) may be specified.

$VideoArchitecture_ReturnValue = 
@{
    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

An integer enumeration indicating the type of video memory.

$VideoMemoryType_ReturnValue = 
@{
    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

Current video mode.

VideoModeDescription

Data type String

The VideoModeDescription property indicates the current resolution, color, and scan mode settings of the video controller.

Example: 1024 x 768 x 256 colors.

VideoProcessor

Data type String

A free-form string describing the video processor/Controller.

Methods

Examples

See Also

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:14:26 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin