This topic has not yet been rated - Rate this topic

Win32_1394ControllerDevice class

Applies to: desktop apps only

The Win32_1394ControllerDevice association WMI class relates the high-speed serial bus (IEEE 1394 Firewire) Controller and the CIM_LogicalDevice instance connected to it. This serial bus provides enhanced connectivity for a wide range of devices, including consumer audio or video components, storage peripherals, other computers, and portable devices. IEEE 1394 has been adopted by the consumer electronics industry and provides a Plug and Play-compatible expansion interface.

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

Copy

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

Members

The Win32_1394ControllerDevice class has these types of members:

Properties

Properties

The Win32_1394ControllerDevice class has these properties.

AccessState

Data type: uint16
Access type: Read-only

State of the controller access to the device. This information is necessary when a logical device can be commanded by, or accessed through, multiple controllers. This property is inherited from CIM_ControlledBy.

Value	Meaning
0	Unknown
1	Active
2	Inactive

Antecedent

Data type: Win32_1394Controller
Access type: Read-only

Reference to the Win32_1394Controller instance associated with this device. This property is inherited from CIM_Dependency.

Dependent

Data type: CIM_LogicalDevice
Access type: Read-only

Reference to the CIM_LogicalDevice instance connected to the 1394 controller. This property is inherited from CIM_Dependency.

NegotiatedDataWidth

Data type: uint32
Access type: Read-only

Date and time several bus or connection data widths are possible, the NegotiatedDataWidth 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 (zero). This property is inherited from CIM_DeviceConnection.

NegotiatedSpeed

Data type: uint64
Access type: Read-only

Date and time several bus or connection speeds are possible, the NegotiatedSpeed 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 (zero). 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. This property is inherited from CIM_ControlledBy.

NumberOfSoftResets

Data type: uint32
Access type: Read-only

Number of soft resets issued by the controller. This property is inherited from CIM_ControlledBy.

Remarks

The Win32_1394ControllerDevice class is derived from CIM_ControlledBy.

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

# wmi-win32_1394ContrrollerDevice.ps1
# Demonstrates use of Win32_Controller WMI class
# Thomas Lee - tfl@psp.co.uk

# Helper function to return AccessState

function get-WmiAccessState {
param ([uint16] $char)

# parse and return values

If ($char -le 2 -and $char -ge 0) {

switch ($char) {
0 {"00-Reserved"}
1 {"01-Reserved"}
2 {"02-Unknown"}
}
}

Else {
"$char - unknown value"
}
}

# Get 1394 Controller Device information from WMI
$1394Cont = Get-WMIObject Win32_1394ControllerDevice

# Display Details
"Win32_1394ControllerDevice WMI Information"
"=========================================="

foreach ($device in $1394Cont) {

"Device Characteristics - Device {0}" -f ++$i

"Access State : {0}" -f (Get-WmiAccessState($ch))
"Antecedent : {0}" -f $device.Antecedent
"Negotiated Data Width : {0}" -f $device.NegotiatedDataWidth
"Negotiated Speed : {0}" -f $device.NegotiatedSpeed
"Number of Hard Resets : {0}" -f $device.NumberofHardResets
"Number of Soft Resets : {0}" -f $device.NumberofSoftResets
}

When run on my laptop, this script returned the following output:

PSH [D:\foo\wmi]: .\wmi-win32_1394ControllerDevice.ps1
Win32_1394ControllerDevice WMI Information
==========================================
Device Characteristics -Device 1
Access State : 00-Reserved
Antecedent : \\UK0N055\root\CIMV2:Win32_1394Controller.DeviceID="PCI\\VEN_1217&DEV_00F7&SUBSYS_01CC1028
&REV_02\\4&2FE911E8&0&0CF0"
Negotiated Data Width :
Negotiated Speed :
Number of Hard Resets :
Number of Soft Resets :
PSH [D:\foo\wmi]:

History

6/10/2007
Thomas Lee

6/10/2007
Thomas Lee