CIM_ControlledBy class

Represents a relationship between a controller and a logical device that is managed by the controller.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[Abstract, Association, Version("2.10.0"), AMENDMENT]
class CIM_ControlledBy : CIM_DeviceConnection
{
  uint64                NegotiatedSpeed;
  uint32                NegotiatedDataWidth;
  CIM_Controller    REF Antecedent;
  CIM_LogicalDevice REF Dependent;
  uint16                AccessState;
  datetime              TimeOfDeviceReset;
  uint32                NumberOfHardResets;
  uint32                NumberOfSoftResets;
  string                DeviceNumber;
  uint16                AccessMode;
  uint16                AccessPriority;
};

Members

The CIM_ControlledBy class has these types of members:

• Properties

Properties

The CIM_ControlledBy class has these properties.

AccessMode

Data type: uint16

Access type: Read-only

This property that describes the accessibility of the device through the controller.

ReadWrite (2)

ReadOnly (3)

NoAccess (4)

AccessPriority

Data type: uint16

Access type: Read-only

The priority for access of the device through the controller. A lower value indicates a higher priority.

AccessState

Data type: uint16

Access type: Read-only

Indicates whether the controller is actively managing the device.

Unknown (0)

Active (1)

Inactive (2)

Antecedent

Data type: CIM_Controller

Access type: Read-only

Qualifiers: Override ("Antecedent")

The controller.

Dependent

Data type: CIM_LogicalDevice

Access type: Read-only

Qualifiers: Override ("Dependent")

The logical devices.

DeviceNumber

Data type: string

Access type: Read-only

The address of the associated device in the context of the controller.

NegotiatedDataWidth

Data type: uint32

Access type: Read-only

Qualifiers: Units ("Bits"), MappingStrings ("MIF.DMTF|Bus Port Association|001.3")

When several bus and connection data widths are possible, the NegotiatedDataWidth property defines the one that is in use between the Devices. Data width is specified in bits. If data width is not negotiated, or if this information is not available or not important to Device management, the property should be set to 0.

This property is inherited from CIM_DeviceConnection.

NegotiatedSpeed

Data type: uint64

Access type: Read-only

Qualifiers: Units ("Bits per Second"), MappingStrings ("MIF.DMTF|Bus Port Association|001.2")

When several bus and connection speeds are possible, this property defines the speed that is in use between the devices, in bits per second. If connection or bus speeds are not negotiated, or if this information is not available, or not important to device management, the property should be set to "0".

This property is inherited from CIM_DeviceConnection.

NumberOfHardResets

Data type: uint32

Access type: Read-only

Qualifiers: Counter

The number of hard resets issued by the controller. A hard reset returns a device to its initialization or boot-up state, after which all internal device state information and data are lost.

NumberOfSoftResets

Data type: uint32

Access type: Read-only

Qualifiers: Counter

The number of soft resets issued by the controller. A soft reset does not clear the device state or data.

TimeOfDeviceReset

Data type: datetime

Access type: Read-only

The time when the downstream device was last reset by the controller.

Requirements

Minimum supported client	None supported
Minimum supported server	Windows Server 2008
End of client support	None supported
End of server support	Windows Server 2012 R2
Namespace	Root\virtualization
MOF	WindowsVirtualization.mof

See also

CIM_DeviceConnection