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-onlyArray 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-onlyGeneral chip set used for this controller to compare compatibilities with the system.
AdapterDACType
-
Data type:
string
Access type: Read-onlyName 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-onlyAvailability and status of the device. Inherited from CIM_LogicalDevice.
Value Meaning 1
0x1Other 2
0x2Unknown 3
0x3Running/Full Power 4
0x4Warning 5
0x5In Test 6
0x6Not Applicable 7
0x7Power Off 8
0x8Off Line 9
0x9Off Duty 10
0xADegraded 11
0xBNot Installed 12
0xCInstall Error 13
0xDPower Save - Unknown The device is known to be in a power save mode, but its exact status is unknown.
14
0xEPower Save - Low Power Mode The device is in a power save state but still functioning, and may exhibit degraded performance.
15
0xFPower Save - Standby The device is not functioning but could be brought to full power quickly.
16
0x10Power Cycle 17
0x11Power Save - Warning The device is in a warning state, though also in a power save mode.
CapabilityDescriptions
-
Data type:
string array
Access type: Read-onlyFree-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-onlySize 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-onlyWin32 Configuration Manager error code.
Value Meaning 0
0x0Device is working properly. 1
0x1Device is not configured correctly. 2
0x2Windows cannot load the driver for this device. 3
0x3Driver for this device might be corrupted, or the system may be low on memory or other resources. 4
0x4Device is not working properly. One of its drivers or the registry might be corrupted. 5
0x5Driver for the device requires a resource that Windows cannot manage. 6
0x6Boot configuration for the device conflicts with other devices. 7
0x7Cannot filter. 8
0x8Driver loader for the device is missing. 9
0x9Device is not working properly; the controlling firmware is incorrectly reporting the resources for the device. 10
0xADevice cannot start. 11
0xBDevice failed. 12
0xCDevice cannot find enough free resources to use. 13
0xDWindows cannot verify the device's resources. 14
0xEDevice cannot work properly until the computer is restarted. 15
0xFDevice is not working properly due to a possible re-enumeration problem. 16
0x10Windows cannot identify all of the resources that the device uses. 17
0x11Device is requesting an unknown resource type. 18
0x12Device drivers need to be reinstalled. 19
0x13Failure using the VxD loader. 20
0x14Registry might be corrupted. 21
0x15System failure. If changing the device driver is ineffective, see the hardware documentation. Windows is removing the device. 22
0x16Device is disabled. 23
0x17System failure. If changing the device driver is ineffective, see the hardware documentation. 24
0x18Device is not present, not working properly, or does not have all of its drivers installed. 25
0x19Windows is still setting up the device. 26
0x1AWindows is still setting up the device. 27
0x1BDevice does not have valid log configuration. 28
0x1CDevice drivers are not installed. 29
0x1DDevice is disabled; the device firmware did not provide the required resources. 30
0x1EDevice is using an IRQ resource that another device is using. 31
0x1FDevice is not working properly; Windows cannot load the required device drivers.
ConfigManagerUserConfig
-
Data type:
boolean
Access type: Read-onlyIf 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-onlyNumber 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-onlyNumber 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-onlyNumber 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-onlyCurrent 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-onlyDescription of the object. This property is inherited from CIM_ManagedSystemElement.
DeviceID
-
Data type:
string
Access type: Read-only
Qualifiers: KeyIdentifier (unique to the computer system) for this video controller. This property is inherited from CIM_LogicalDevice.
DeviceSpecificPens
-
Data type:
uint32
Access type: Read-onlyCurrent 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-onlyDither 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-onlyLast modification date and time of the currently-installed video driver.
DriverVersion
-
Data type:
string
Access type: Read-onlyVersion number of the video driver.
ErrorCleared
-
Data type:
boolean
Access type: Read-onlyIf TRUE, the error reported in LastErrorCode property is now cleared. This property is inherited from CIM_LogicalDevice.
ErrorDescription
-
Data type:
string
Access type: Read-onlyFree-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-onlySpecific 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-onlyMethod 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-onlyPath to the video adapter's .inf file.
Example: "C:/WINNT/SYSTEM32/DRIVERS"
InfSection
-
Data type:
string
Access type: Read-onlySection of the .inf file where the Windows video information resides.
InstallDate
-
Data type:
datetime
Access type: Read-onlyDate 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-onlyName of the installed display device driver.
LastErrorCode
-
Data type:
uint32
Access type: Read-onlyLast 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-onlyMaximum 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-onlyIf TRUE, gray scale is used to display images.
Name
-
Data type:
string
Access type: Read-onlyLabel 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-onlyCurrent 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-onlyNumber 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-onlyWindows 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-onlyArray of the specific power-related capabilities of a logical device. This property is inherited from CIM_LogicalDevice.
Value Meaning 0
0x0Unknown 1
0x1Not Supported 2
0x2Disabled 3
0x3Enabled The power management features are currently enabled but the exact feature set is unknown or the information is unavailable.
4
0x4Power Saving Modes Entered Automatically The device can change its power state based on usage or other criteria.
5
0x5Power 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
0x6Power Cycling Supported The SetPowerState method can be invoked with the PowerState parameter set to 5 (Power Cycle).
7
0x7Timed 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-onlyIf 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-onlyProtocol used by the controller to access 'controlled' devices. This property is inherited from CIM_Controller. Values are:
Value Meaning 1
0x1Other 2
0x2Unknown 3
0x3EISA 4
0x4ISA 5
0x5PCI 6
0x6ATA/ATAPI 7
0x7Flexible Diskette 8
0x81496 9
0x9SCSI Parallel Interface 10
0xASCSI Fibre Channel Protocol 11
0xBSCSI Serial Bus Protocol 12
0xCSCSI Serial Bus Protocol-2 (1394) 13
0xDSCSI Serial Storage Architecture 14
0xEVESA 15
0xFPCMCIA 16
0x10Universal Serial Bus 17
0x11Parallel Protocol 18
0x12ESCON 19
0x13Diagnostic 20
0x14I2C 21
0x15Power 22
0x16HIPPI 23
0x17MultiBus 24
0x18VME 25
0x19IPI 26
0x1AIEEE-488 27
0x1BRS232 28
0x1CIEEE 802.3 10BASE5 29
0x1DIEEE 802.3 10BASE2 30
0x1EIEEE 802.3 1BASE5 31
0x1FIEEE 802.3 10BROAD36 32
0x20IEEE 802.3 100BASEVG 33
0x21IEEE 802.5 Token-Ring 34
0x22ANSI X3T9.5 FDDI 35
0x23MCA 36
0x24ESDI 37
0x25IDE 38
0x26CMD 39
0x27ST506 40
0x28DSSI 41
0x29QIC2 42
0x2AEnhanced ATA/IDE 43
0x2BAGP 44
0x2CTWIRP (two-way infrared) 45
0x2DFIR (fast infrared) 46
0x2ESIR (serial infrared) 47
0x2FIrBus
ReservedSystemPaletteEntries
-
Data type:
uint32
Access type: Read-onlyNumber 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-onlyVersion 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-onlyState 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-onlyValue of the scoping computer's CreationClassName property. This property is inherited from CIM_LogicalDevice.
SystemName
-
Data type:
string
Access type: Read-onlyName of the scoping system. This property is inherited from CIM_LogicalDevice.
SystemPaletteEntries
-
Data type:
uint32
Access type: Read-onlyCurrent 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-onlyDate 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-onlyType 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-onlyType 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-onlyCurrent video mode. This property is inherited from CIM_PCVideoController.
VideoModeDescription
-
Data type:
string
Access type: Read-onlyCurrent resolution, color, and scan mode settings of the video controller.
Example: "1024 x 768 x 256 colors"
VideoProcessor
-
Data type:
string
Access type: Read-onlyFree-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. |