This topic has not yet been rated - Rate this topic

CIM_ControlledBy class

Applies to: desktop apps only

The CIM_ControlledBy relationship indicates which devices are commanded by, or accessed through, the controller logical device.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class CIM_ControlledBy : CIM_DeviceConnection
{
  uint16            AccessState;
  CIM_Controller    REF Antecedent;
  CIM_LogicalDevice REF Dependent;
  uint32            NegotiatedDataWidth;
  uint64            NegotiatedSpeed;
  uint32            NumberOfHardResets;
  uint32            NumberOfSoftResets;
};

Members

The CIM_ControlledBy class has these types of members:

Properties

The CIM_ControlledBy class has these properties.

AccessState
Data type: uint16
Access type: Read-only

Indicates whether the controller is actively commanding or accessing the device. This information is necessary when a logical device can be commanded by, or accessed through, multiple controllers.

ValueMeaning
0

Unknown

1

Active

2

Inactive

 

Antecedent
Data type: CIM_Controller
Access type: Read-only

Reference to the controller. This property is inherited from CIM_Dependency.

Dependent
Data type: CIM_LogicalDevice
Access type: Read-only

Reference to the controlled device. This property is inherited from CIM_Dependency.

NegotiatedDataWidth
Data type: uint32
Access type: Read-only

When several bus or connection data widths are possible, this property defines the one 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 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

When several bus or connection speeds are possible, this property defines the one in use between the devices. Speed is specified in bits-per-second. If connection or bus speeds are not negotiated, or if this information is not available or important to device management, the property should be set to 0. This property is inherited from CIM_DeviceConnection.

For more information about using uint64 values in scripts, see Scripting in WMI.

NumberOfHardResets
Data type: uint32
Access type: Read-only

Number of hard resets issued by the controller. A hard reset returns the device to its initialization or boot-up state. All internal device state information and data are lost.

NumberOfSoftResets
Data type: uint32
Access type: Read-only

Number of soft resets issued by the controller. A soft reset does not completely clear current device state and data. Exact semantics are dependent on the device and on the protocols and mechanisms used to communicate to it.

Remarks

The CIM_ControlledBy class is derived from CIM_DeviceConnection.

WMI does not implement this class. For more information about classes derived from CIM_ControlledBy, see Win32 Classes.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

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

Minimum supported server

Windows 2000 Server

Namespace

\root\CIMV2

MOF

Cimwin32.mof

DLL

Cimwin32.dll

 

 

Send comments about this topic to Microsoft

Build date: 3/9/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ