This topic has not yet been rated - Rate this topic

Win32_DMAChannel class

The Win32_DMAChannel WMI class represents a direct memory access (DMA) channel on a computer system running Windows. DMA is a method of moving data from a device to memory (or vice versa) without the help of the microprocessor. The system board uses a DMA controller to handle a fixed number of channels, each of which can be used by one (and only one) device at a time.

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_DMAChannel : CIM_DMA
{
  uint16   AddressSize;
  uint16   Availability;
  boolean  BurstMode;
  uint16   ByteMode;
  string   Caption;
  uint16   ChannelTiming;
  string   CreationClassName;
  string   CSCreationClassName;
  string   CSName;
  string   Description;
  uint32   DMAChannel;
  datetime InstallDate;
  uint32   MaxTransferSize;
  string   Name;
  uint32   Port;
  string   Status;
  uint16   TransferWidths[];
  uint16   TypeCTiming;
  uint16   WordMode;
};

Members

The Win32_DMAChannel class has these types of members:

Properties

Properties

The Win32_DMAChannel class has these properties.

AddressSize

Data type: uint16
Access type: Read-only

DMA channel address size—in bits. Permissible values are 8, 16, 32, or 64 bits. If unknown, enter 0 (zero). This property is inherited from CIM_DMA.

Availability

Data type: uint16
Access type: Read-only

Availability of the DMA. This property is inherited from CIM_DMA.

Value	Meaning
1	Other
2	Unknown
3	Available
4	In Use or Not Available
5	In Use and Available or Sharable

BurstMode

Data type: boolean
Access type: Read-only

Indicates whether or not the DMA channel supports burst mode. This property is inherited from CIM_DMA.

ByteMode

Data type: uint16
Access type: Read-only

DMA execution mode. This property is inherited from CIM_DMA.

Value	Meaning
1	Other
2	Unknown
3	Does not execute in "count by byte" mode
4	Execute in "count by byte" mode

Caption

Data type: string
Access type: Read-only

Short description of the object—a one-line string. This property is inherited from CIM_ManagedSystemElement.

ChannelTiming

Data type: uint16
Access type: Read-only

DMA channel timing. This property is inherited from CIM_DMA.

Value	Meaning
1	Other
2	Unknown
3	ISA Compatible
4	Type A
5	Type B
6	Type F

CreationClassName

Data type: string
Access type: Read-only

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_DMA.

CSCreationClassName

Data type: string
Access type: Read-only

Name of the scoping computer system creation class. This property is inherited from CIM_DMA.

CSName

Data type: string
Access type: Read-only

Name of the scoping computer system. This property is inherited from CIM_DMA.

Description

Data type: string
Access type: Read-only

Description of the object. This property is inherited from CIM_ManagedSystemElement.

DMAChannel

Data type: uint32
Access type: Read-only

DMA channel number, part of the object's key value. This property is inherited from CIM_DMA.

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.

MaxTransferSize

Data type: uint32
Access type: Read-only

Maximum number of bytes that can be transferred by this DMA channel. If unknown, enter 0 (zero). This property is inherited from CIM_DMA.

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.

Port

Data type: uint32
Access type: Read-only

DMA port used by the host bus adapter. This is meaningful for MCA-type buses.

Example: 12

Status

Data type: string
Access type: Read-only

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. This property is inherited from CIM_ManagedSystemElement.

The values are:

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

TransferWidths

Data type: uint16 array
Access type: Read-only

Array of all the transfer widths (in bits) supported by this DMA channel. If unknown, enter 0 (zero). This property is inherited from CIM_DMA.

TypeCTiming

Data type: uint16
Access type: Read-only

Support for C type (burst) timing. This property is inherited from CIM_DMA.

Value	Meaning
1	Other
2	Unknown
3	ISA Compatible
4	Not Supported
5	Supported

WordMode

Data type: uint16
Access type: Read-only

DMA execution mode. This property is inherited from CIM_DMA.

Value	Meaning
1	Other
2	Unknown
3	Does not execute in "count by word" mode
4	Execute in "count by word" mode

Remarks

The Win32_DMAChannel class is derived from CIM_DMA.

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

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Namespace	\root\CIMV2
MOF	Cimwin32.mof
DLL	Cimwin32.dll

Community Additions

ADD