通过ManagementClass 获得显卡的一些基本信息(Win32_VideoController )

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.