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

[Dynamic, Provider("CIMWin32"), UUID("{8502C4D1-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
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

The Win32_DMAChannel class has these properties.

AddressSize

Data type: uint16

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|System Resource DMA Info|001.3"), Units ("bits")

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.

(0)

(8)

(16)

(32)

(64)

Availability

Data type: uint16

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|DMA|001.2")

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

Other (1)

Unknown (2)

Available (3)

In Use/Not Available (4)

In Use or Not Available

In Use and Available/Shareable (5)

In Use and Available or Sharable

BurstMode

Data type: boolean

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|DMA|001.3")

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

Qualifiers: MappingStrings ("MIF.DMTF|System Resource DMA Info|001.7")

DMA execution mode.

This property is inherited from CIM_DMA.

Other (1)

Unknown (2)

Not execute in 'count by byte' mode (3)

Does not execute in "count by byte" mode

Execute in 'count by byte' mode (4)

Execute in "count by byte" mode

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64), DisplayName ("Caption")

Short description of the object a one-line string.

This property is inherited from CIM_ManagedSystemElement.

ChannelTiming

Data type: uint16

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|System Resource DMA Info|001.9")

DMA channel timing.

This property is inherited from CIM_DMA.

Other (1)

Unknown (2)

ISA Compatible (3)

Type A (4)

Type B (5)

Type F (6)

CreationClassName

Data type: string

Access type: Read-only

Qualifiers: MaxLen (256), CIM_Key

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

Qualifiers: Propagated ("CIM_ComputerSystem.CreationClassName"), MaxLen (256), CIM_Key

Name of the scoping computer system creation class.

This property is inherited from CIM_DMA.

CSName

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_ComputerSystem.Name"), CIM_Key, MaxLen (256)

Name of the scoping computer system.

This property is inherited from CIM_DMA.

Description

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Description")

Description of the object.

This property is inherited from CIM_ManagedSystemElement.

DMAChannel

Data type: uint32

Access type: Read-only

Qualifiers: Key, MappingStrings ("MIF.DMTF|DMA|001.1")

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

Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")

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

Qualifiers: MappingStrings ("MIF.DMTF|System Resource DMA Info|001.4"), Units ("bytes")

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

Qualifiers: DisplayName ("Name")

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

Qualifiers: MappingStrings ("Win32API|System Structures|CM_PARTIAL_RESOURCE_DESCRIPTOR|Dma|Port")

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

Qualifiers: MaxLen (10), DisplayName ("Status")

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.

Values include the following:

OK ("OK")

Error ("Error")

Degraded ("Degraded")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Starting ("Starting")

Stopping ("Stopping")

Service ("Service")

Stressed ("Stressed")

NonRecover ("NonRecover")

No Contact ("No Contact")

Lost Comm ("Lost Comm")

TransferWidths

Data type: uint16 array

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|System Resource DMA Info|001.2"), Units ("bits")

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.

(0)

(8)

(16)

(32)

(64)

(128)

TypeCTiming

Data type: uint16

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|System Resource DMA Info|001.10")

Support for C type (burst) timing.

This property is inherited from CIM_DMA.

Other (1)

Unknown (2)

ISA Compatible (3)

Not Supported (4)

Supported (5)

WordMode

Data type: uint16

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|System Resource DMA Info|001.8")

DMA execution mode.

This property is inherited from CIM_DMA.

Other (1)

Unknown (2)

Not execute in 'count by word' mode (3)

Does not execute in "count by word" mode

Execute in 'count by word' mode (4)

Execute in "count by word" mode

Remarks

The Win32_DMAChannel class is derived from CIM_DMA.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

See also

CIM_DMA

Computer System Hardware Classes