CIMWin32 WMI 提供程序的 (CIM_USBDevice 类)

CIM _ USBDevice 类表示 USB 设备的管理特性。

重要

DMTF (分布式管理任务组) CIM (通用信息模型) 类是在其上构建 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本的架构

以下语法简化了托管对象格式 (MOF) 代码,并包含其所有继承属性。 属性按字母顺序列出,而不是按 MOF 顺序列出。

语法

[AMENDMENT]
class CIM_USBDevice : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  uint8    ClassCode;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  uint8    CurrentAlternateSettings[];
  uint8    CurrentConfigValue;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Name;
  uint8    NumberOfConfigs;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint8    ProtocolCode;
  string   Status;
  uint16   StatusInfo;
  uint8    SubclassCode;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   USBVersion;
};

成员

CIM _ USBDevice 类具有以下类型的成员:

方法

CIM _ USBDevice 类具有这些方法。

方法 说明
GetDescriptor 返回 USB 设备描述符。 不是由 WMI 实现的。
& 请求重置逻辑设备。 不是由 WMI 实现的。
SetPowerState 定义逻辑设备的所需电源状态以及设备应置于该状态的时间。 不是由 WMI 实现的。

属性

CIM _ USBDevice 类具有以下属性。

可用性

数据类型: uint16

访问类型:只读

限定符: MappingStrings ( "MIF。DMTF | 操作状态 | 003.5 "," MIB。IETF | 主机资源-hrDeviceStatus ")

设备的可用性和状态。

此属性是从 CIM _ LogicalDevice继承而来的。

其他 (1)

未知 (2)

运行/完整 Power (3)

运行或全速

警告 (4)

在测试 (5)

不适用 (6)

断电 (7)

空行 (8)

关闭关税 (9)

(10) 降级

未安装 (11)

安装错误 (12)

节能-未知 (13)

已知设备处于省电模式,但其确切状态为未知。

电-低功耗模式 (14)

设备处于省电状态,但仍处于正常工作状态,并且可能会导致性能下降。

节能-备用 (15)

设备无法正常工作,但可能会迅速进入全部电量。

电源周期 (16)

节能-警告 (17)

设备处于警告状态,但也处于省电模式。

暂停 (18)

设备已暂停。

未准备好 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备为静默设备。

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64) , DisplayName ( "Caption" )

对象的简短文本说明。

此属性是从 CIM _ ManagedSystemElement继承而来的。

ClassCode

数据类型: uint8

访问类型:只读

USB 类代码。

ConfigManagerErrorCode

数据类型: uint32

访问类型:只读

限定符: Schema ( "Win32" )

Win32 Configuration Manager 错误代码。

此属性是从 CIM _ LogicalDevice继承而来的。

此设备工作正常。 (0)

设备工作正常。

此设备配置不正确。 (1)

设备配置不正确。

Windows 无法加载此设备的驱动程序。 (2)

此设备的驱动程序可能已损坏,或者系统内存或其他资源不足。 (3)

此设备的驱动程序可能已损坏,或者系统内存或其他资源不足。

此设备工作不正常。其中一个驱动程序或注册表可能已损坏。 (4)

设备工作不正常。 其中一个驱动程序或注册表可能已损坏。

此设备的驱动程序需要 Windows 不能管理的资源。 (5)

设备的驱动程序需要 Windows 无法管理的资源。

此设备的启动配置与其他设备冲突。 (6)

设备的启动配置与其他设备冲突。

无法筛选。 (7)

缺少设备的驱动程序加载程序。 (8)

缺少设备的驱动程序加载程序。

此设备无法正常工作,因为控制固件无法正确报告设备的资源。 (9)

设备工作不正常。 控制固件错误地报告了设备的资源。

此设备无法启动。 (10)

设备无法启动。

此设备失败。 (11)

设备失败。

此设备找不到足够的可用资源。 (12)

设备找不到足够的可用资源。

Windows 无法验证此设备的资源。 (13)

Windows 无法验证设备的资源。

在重新启动计算机之前,该设备无法正常工作。 (14)

在重新启动计算机之前,设备无法正常工作。

此设备无法正常工作,因为可能存在重新枚举问题。 (15)

设备无法正常工作,因为可能存在重新枚举问题。

Windows 无法识别此设备使用的所有资源。 (16)

Windows 无法识别设备使用的所有资源。

此设备正在请求未知的资源类型。 (17)

设备正在请求未知的资源类型。

重新安装此设备的驱动程序。 (18)

必须重新安装设备驱动程序。

使用 VxD 加载程序失败。 (19)

注册表可能已损坏。 (20)

注册表可能已损坏。

系统失败:尝试更改此设备的驱动程序。如果这不起作用,请参阅硬件文档。Windows 正在删除此设备。 (21)

系统失败。 如果更改设备驱动程序无效,请参阅硬件文档。 Windows 正在删除设备。

此设备处于禁用状态。 (22)

设备处于禁用状态。

系统失败:尝试更改此设备的驱动程序。如果这不起作用,请参阅硬件文档。 (23)

系统失败。 如果更改设备驱动程序无效,请参阅硬件文档。

此设备不存在、未正常工作或没有安装其所有驱动程序。 (24)

设备不存在、未正常工作或没有安装其所有驱动程序。

Windows 仍在设置此设备。 (25)

Windows 仍在设置设备。

Windows 仍在设置此设备。 (26)

Windows 仍在设置设备。

此设备没有有效的日志配置。 (27)

设备没有有效的日志配置。

此设备的驱动程序未安装。 (28)

未安装设备驱动程序。

此设备已被禁用,因为设备的固件没有为其提供所需的资源。 (29)

设备处于禁用状态。 设备固件未提供所需的资源。

此设备正在将中断请求 (IRQ) 使用其他设备的资源。 (30)

设备使用的是另一台设备正在使用的 IRQ 资源。

此设备无法正常工作,因为 Windows 无法加载此设备所需的驱动程序。 (31)

设备工作不正常。 Windows 无法加载所需的设备驱动程序。

ConfigManagerUserConfig

数据类型: 布尔值

访问类型:只读

限定符: Schema ( "Win32" )

如果 为 TRUE,则设备使用的是用户定义的配置。

此属性是从 CIM _ LogicalDevice继承而来的。

CreationClassName

数据类型: 字符串

访问类型:只读

限定符: CIM _ 密钥

创建实例时使用的类或子类的名称。 与类的其他键属性一起使用时,此属性允许唯一标识类及其子类的所有实例。

此属性是从 CIM _ LogicalDevice继承而来的。

CurrentAlternateSettings

数据类型: uint8 数组

访问类型:只读

限定符: ModelCorrespondence ( "CIM _ USBDeviceCurrentConfigValue")

当前所选配置中每个接口的 USB 备用设置 (CurrentConfigValue 属性) 指示。 此数组为配置中的每个接口提供一个条目。 如果 CurrentConfigValue 属性的值为 0 (零) ,这表示未配置设备,则不定义此数组。 有关分析此八进制字符串的信息,请参阅 USB 规范。

CurrentConfigValue

数据类型 :uint8

访问类型:只读

限定符 :ModelCorrespondence (" CIM _ USBDeviceCurrentAlternateSettings")

当前为设备选择的配置。 如果值为 0 (零) ,则设备未配置。

说明

数据类型 :string

访问类型:只读

限定符 :DisplayName ("Description")

对象的文本说明。

此属性继承自 CIM _ ManagedSystemElement

DeviceID

数据类型 :string

访问类型:只读

限定符 :CIM _ 键

用于唯一命名逻辑设备的地址或其他标识信息。

此属性继承自 CIM _ LogicalDevice

ErrorCleared

数据类型: 布尔值

访问类型:只读

如果 为 TRUE, 则现在清除 LastErrorCode 属性中报告的错误。

此属性继承自 CIM _ LogicalDevice

ErrorDescription

数据类型 :string

访问类型:只读

自由格式字符串,提供有关 LastErrorCode 属性中记录的错误以及要执行的操作的信息。

此属性继承自 CIM _ LogicalDevice

InstallDate

数据类型 :datetime

访问类型:只读

限定符 :MappingStrings ("MIF"。DMTF | ComponentID | 001.5") ,DisplayName ("Install Date")

对象的安装日期和时间。 此属性不需要值来指示对象已安装。

此属性继承自 CIM _ ManagedSystemElement

LastErrorCode

数据类型 :uint32

访问类型:只读

逻辑设备报告的上一个错误代码。

此属性继承自 CIM _ LogicalDevice

名称

数据类型 :string

访问类型:只读

限定符 :DisplayName ("Name")

对象已知的标签。 子类时,此属性可以重写为键属性。

此属性继承自 CIM _ ManagedSystemElement

NumberOfConfigs

数据类型 :uint8

访问类型:只读

为设备定义的设备配置数。

PNPDeviceID

数据类型 :string

访问类型:只读

限定符: 架构 ("Win32")

Win32 即插即用逻辑设备的设备标识符。 此属性继承自 CIM _ LogicalDevice

示例 * :"PNP030b"

PowerManagementCapabilities

数据类型 :uint16 数组

访问类型:只读

逻辑设备的特定电源相关功能的数组。

此属性继承自 CIM _ LogicalDevice

未知 (0)

不支持 ( 1)

已禁用 (2)

已启用 (3)

电源管理功能当前已启用,但确切的功能集未知或信息不可用。

自动输入的省电模式 ( 4)

设备可以基于使用情况或其他条件更改其电源状态。

Power State Settable (5)

支持 SetPowerState方法。 此方法在父 CIM _ LogicalDevice 类上找到,可以实现。 有关详细信息,请参阅设计MOF 托管对象格式 (类) MOF。

Power 循环支持 ( 6)

可以使用 Power Cycle 参数设置为 5 的 PowerState 参数调用 SetPowerState (Power Cycle) 。

支持的 7 ( 时间电源)

可以 调用 SetPowerState 方法,将 PowerState 参数设置为 5 (Power Cycle) ,将 Time 设置为特定日期和时间(或间隔)以打开电源。

PowerManagementSupported

数据类型: 布尔值

访问类型:只读

如果 为 TRUE, 则设备可以电源管理,即进入省电状态。 如果 为 FALSE, 则整数值 1 ("不支持") 应为 PowerManagementCapabilities 数组中的唯一 条目。

此属性不指示当前是否启用了电源管理功能,或者如果已启用,则哪些功能受支持。 有关详细信息,请参阅 PowerManagementCapabilities 数组。 此属性继承自 CIM _ LogicalDevice

ProtocolCode

数据类型 :uint8

访问类型:只读

USB 协议代码。

状态

数据类型 :string

访问类型:只读

限定符 :MaxLen (10 ) ,DisplayName ("Status")

对象的当前状态。 此属性继承自 CIM _ ManagedSystemElement

包括以下值:

确定 ("确定")

错误 ("错误")

降级 ( "降级" )

未知 的 ( "unknown" )

Pred 失败 ( "Pred fail" )

开始 ( "开始" )

正在停止 ( "正在停止" )

服务 ( "服务" )

压力 ( "压力" )

NonRecover ( "NonRecover" )

没有联系人 ( "无联系" )

通信丢失 ( "已丢失通信" )

StatusInfo

数据类型: uint16

访问类型:只读

限定符: MappingStrings ( "MIF。DMTF | 操作状态 | 003.3 ")

逻辑设备的状态。 如果此属性不适用于逻辑设备,则值 5 (不适用) 应使用。

此属性是从 CIM _ LogicalDevice继承而来的。

其他 (1)

未知 (2)

已启用 (3)

已禁用 (4)

不适用 (5)

SubclassCode

数据类型: uint8

访问类型:只读

USB 子类代码。

SystemCreationClassName

数据类型: 字符串

访问类型:只读

限定符: ( "CIM _ 系统传播CreationClassName") , CIM _ 密钥

作用域系统的创建类名称。

此属性是从 CIM _ LogicalDevice继承而来的。

SystemName

数据类型: 字符串

访问类型:只读

限定符: ( "CIM _ 系统传播名称") , CIM _ 密钥

作用域系统的名称。

此属性是从 CIM _ LogicalDevice继承而来的。

USBVersion

数据类型: uint16

访问类型:只读

USB 设备支持的最新 USB 版本。 此属性表示为二进制编码的十进制 (BCD) ,其中小数点在第二个和第三个数字之间。 例如,0x201 的值指示支持版本2.01。

备注

Cim _ USBDevice 类派生自 cim _ LogicalDevice

WMI 不实现此类。 对于实现 CIM _ USBDEVICE 的 WMI 类,请参阅 Win32 类

此文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已进行了更改以更正次要错误、符合 Microsoft SDK 文档标准,或者提供详细信息。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
根 \ CIMV2
MOF
CIMWin32
DLL
CIMWin32.dll

另请参阅

CIM _ LogicalDevice