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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Namespace | Root\CIMV2 |
| MOF | CIMWin32.mof |
| DLL | CIMWin32.dll |
See also
Computer System Hardware Classes
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
