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

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

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

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

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

Number of installed services and device driver services provided by the operating system.

Example: 1024

SoftwareElementID

Data type: string

Access type: Read-only

Qualifiers: Key, MaxLen (256)

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

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

Version of the VXD driver.

Example: "3.51"

Remarks

The Win32_DriverVXD class is derived from CIM_SoftwareElement.

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

See also

Operating System Classes

Send comments about this topic to Microsoft

Build date: 11/19/2012