Win32_DriverVXD class
[The Win32_DriverVXD class is no longer available for use as of Windows Vista.]
The Win32_DriverVXD WMI class represents a virtual device driver on a computer system running Windows.
A virtual device is a program that manages a system resource, such as a hardware device or installed software, so that more than one application can use the resource at the same time. Windows uses virtual devices to allow multitasking for Windows-based applications. The virtual devices work in conjunction with Windows to process interrupts, and carry out I/O operations for a given application, without disrupting the execution of other applications.
Most virtual devices manage a hardware device and many also manage or replace corresponding software, such as ROM BIOS routines. A virtual device can contain the device-specific code needed to carry out actions on the device or it can rely on the other software to carry out these operations. In all cases, the virtual device keeps track of the state of the device for each application and ensures that the device is in the correct state whenever an application continues execution.
Some virtual devices manage only installed software, such as an MS-DOS device driver or a terminate-and-stay-resident (TSR) program. Such virtual devices often contain code that either emulates the software or ensures that the software uses data that applies only to the currently running application. Virtual devices are sometimes used to improve the performance of installed software; the Intel-compatible microprocessors can execute the 32-bit code of a virtual device more efficiently than the 16-bit code of an MS-DOS device driver or TSR.
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
[DEPRECATED, Dynamic, Provider("CIMWin32"), UUID("{8502C4C8-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_DriverVXD : CIM_SoftwareElement
{
string BuildNumber;
string Caption;
string CodeSet;
string Control;
string Description;
string DeviceDescriptorBlock;
string IdentificationCode;
datetime InstallDate;
string LanguageEdition;
string Manufacturer;
string Name;
string OtherTargetOS;
string PM_API;
string SerialNumber;
uint32 ServiceTableSize;
string SoftwareElementID;
uint16 SoftwareElementState;
string Status;
uint16 TargetOperatingSystem;
string V86_API;
string Version;
};
Members
The Win32_DriverVXD class has these types of members:
- Properties
Properties
The Win32_DriverVXD class has these properties.
BuildNumber
Data type: string
Access type: Read-only
Internal identifier for this compilation of this software element.
Caption
Data type: string
Access type: Read-only
Short description of the object.
CodeSet
Data type: string
Access type: Read-only
Code set used by this software element.
Control
Data type: string
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32DDK|Virtual Devices|Device Control Procedure")
Offset address to the driver control procedures. The virtual machine manager calls this procedure to send control messages to the virtual device system. The system sends control messages direct to the virtual device to carry out actions. An example of an action is initializing itself; another is notifying the virtual device of changes to virtual machines (such as when a virtual machine is being created).
Description
Data type: string
Access type: Read-only
Description of the object.
DeviceDescriptorBlock
Data type: string
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32DDK|Virtual Devices|Device Descriptor Block")
Offset address to the device descriptor block (DDB) structure. The DDB contains information that the operating system uses to execute the procedures of the driver, including its location in the interrupt list, and other data to run and communicate with this virtual device driver (VxD).
IdentificationCode
Data type: string
Access type: Read-only
Manufacturer identifier for this software element. Often this will be a stock-keeping unit (SKU) or a part number.
InstallDate
Data type: datetime
Access type: Read-only
Object was installed. This property does not need a value to indicate that the object is installed.
LanguageEdition
Data type: string
Access type: Read-only
Language edition of this software element. The language codes defined in ISO 639 should be used. Where the software element represents multilingual or international version of a product, the string "multilingual" should be used.
Manufacturer
Data type: string
Access type: Read-only
Manufacturer of this software element.
Name
Data type: string
Access type: Read-only
Name used to identify this software element.
OtherTargetOS
Data type: string
Access type: Read-only
Manufacturer and operating system type for a software element when the TargetOperatingSystem property has a value of 1 (Other). Therefore, when the TargetOperatingSystem property has a value of Other, the OtherTargetOS property must have a nonnull value. For all other values of TargetOperatingSystem, the OtherTargetOS property is to be NULL.
PM_API
Data type: string
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32DDK|Virtual Devices|Device Descriptor Block|PM_API")
Offset address to the protected mode application programming interface for this VxD. These functions can give applications direct access to the features of the VxD.
SerialNumber
Data type: string
Access type: Read-only
Assigned serial number of this software element.
ServiceTableSize
Data type: uint32
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32DDK|Virtual Devices|Device Descriptor Block|ServiceTableSize")
Number of installed services and device driver services provided by the operating system.
Example: 1024
SoftwareElementID
Data type: string
Access type: Read-only
Identifier for this software element, designed to be used in conjunction with other keys to create a unique representation of this CIM_SoftwareElement instance.
SoftwareElementState
Data type: uint16
Access type: Read-only
State of a software element.
Deployable (1)
Installable (2)
Executable (3)
Running (4)
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.
The values are:
"OK"
"Error"
"Degraded"
"Unknown"
"Pred Fail"
"Starting"
"Stopping"
"Service"
"Stressed"
"NonRecover"
"No Contact"
"Lost Comm"
TargetOperatingSystem
Data type: uint16
Access type: Read-only
Target operating system of the owning software element. The possible values for this property are as follows.
Unknown (0)
Other (1)
MACOS (2)
ATTUNIX (3)
DGUX (4)
DECNT (5)
Digital UNIX (6)
OpenVMS (7)
HPUX (8)
AIX (9)
MVS (10)
OS400 (11)
OS/2 (12)
JavaVM (13)
MSDOS (14)
WIN3x (15)
WIN95 (16)
WIN98 (17)
WINNT (18)
WINCE (19)
NCR3000 (20)
NetWare (21)
OSF (22)
DC/OS (23)
Reliant UNIX (24)
SCO UnixWare (25)
SCO OpenServer (26)
Sequent (27)
IRIX (28)
Solaris (29)
SunOS (30)
U6000 (31)
ASERIES (32)
TandemNSK (33)
TandemNT (34)
BS2000 (35)
LINUX (36)
Lynx (37)
XENIX (38)
VM/ESA (39)
Interactive UNIX (40)
BSDUNIX (41)
FreeBSD (42)
NetBSD (43)
GNU Hurd (44)
OS9 (45)
MACH Kernel (46)
Inferno (47)
QNX (48)
EPOC (49)
IxWorks (50)
VxWorks (51)
MiNT (52)
BeOS (53)
HP MPE (54)
NextStep (55)
PalmPilot (56)
Rhapsody (57)
Windows 2000 (58)
Dedicated (59)
VSE (60)
TPF (61)
V86_API
Data type: string
Access type: Read-only
Qualifiers: DEPRECATED, MappingStrings ("Win32DDK|Virtual Devices|Device Descriptor Block|V86_API")
Offset to the application programming interface for use under virtual 8086 mode. These functions can give applications direct access to the features of the VXD.
Version
Data type: string
Access type: Read-only
Qualifiers: DEPRECATED, Override ("Version") , MappingStrings ("Win32DDK|Virtual Devices|Device Descriptor Block|DDB_Dev_Major_Version,DDB_Dev_Minor_Version")
Version of the VXD driver.
Example: "3.51"
Remarks
The Win32_DriverVXD class is derived from CIM_SoftwareElement.
Requirements
End of client support |
None supported |
End of server support |
Windows Server 2003 |
Namespace |
Root\CIMV2 |
MOF |
CIMWin32.mof |
DLL |
CIMWin32.dll |