CIM_USBDevice类 (CIMWin32 WMI 提供程序)

CIM_USBDevice类表示 USB 设备的管理特征。

重要

DMTF (分布式管理工作组) CIM (Common Information Model) 类是生成 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|HOST-RESOURCES-MIB.hrDeviceStatus“)

设备的可用性和状态。

此属性继承自 CIM_LogicalDevice

其他 (1)

未知 (2)

运行/全能 (3)

正在运行或全能

警告 (4)

在测试 (5)

不适用 (6)

关机 (7)

下线 (8)

下班 (9)

降级 (10)

未安装 (11)

安装错误 (12)

省电 - 未知 (13)

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

省电 - 低功率模式 (14)

设备处于省电状态,但仍正常运行,并可能表现出性能下降。

省电 - 备用 (15)

设备无法正常运行,但可以快速提供全功率。

Power Cycle (16)

省电 - 警告 (17)

设备处于警告状态,同时处于省电模式。

已暂停 (18)

设备已暂停。

未就绪 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备安静。

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement

ClassCode

数据类型: uint8

访问类型:只读

USB 类代码。

ConfigManagerErrorCode

数据类型: uint32

访问类型:只读

限定符: 架构 (“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

数据类型: 布尔值

访问类型:只读

限定符: 架构 (“Win32”)

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

此属性继承自 CIM_LogicalDevice

CreationClassName

数据类型: 字符串

访问类型:只读

限定符: CIM_Key

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

此属性继承自 CIM_LogicalDevice

CurrentAlternateSettings

数据类型: uint8 数组

访问类型:只读

限定符: ModelCorrespondence (“CIM_USBDeviceCurrentConfigValue“)

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

CurrentConfigValue

数据类型: uint8

访问类型:只读

限定符: ModelCorrespondence (“CIM_USBDeviceCurrentAlternateSettings“)

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

说明

数据类型: 字符串

访问类型:只读

限定符: DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement

DeviceID

数据类型: 字符串

访问类型:只读

限定符: CIM_Key

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

此属性继承自 CIM_LogicalDevice

ErrorCleared

数据类型: 布尔值

访问类型:只读

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

此属性继承自 CIM_LogicalDevice

ErrorDescription

数据类型: 字符串

访问类型:只读

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

此属性继承自 CIM_LogicalDevice

InstallDate

数据类型: datetime

访问类型:只读

限定符: MappingStrings (“MIF。DMTF|ComponentID|001.5“) , DisplayName (”安装日期“)

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

此属性继承自 CIM_ManagedSystemElement

LastErrorCode

数据类型: uint32

访问类型:只读

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

此属性继承自 CIM_LogicalDevice

名称

数据类型: 字符串

访问类型:只读

限定符: DisplayName (“Name”)

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

此属性继承自 CIM_ManagedSystemElement

NumberOfConfigs

数据类型: uint8

访问类型:只读

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

PNPDeviceID

数据类型: 字符串

访问类型:只读

限定符: 架构 (“Win32”)

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

示例:“*PNP030b”

PowerManagementCapabilities

数据类型: uint16 数组

访问类型:只读

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

此属性继承自 CIM_LogicalDevice

未知 (0)

不支持 (1)

禁用 (2)

已启用 (3)

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

自动输入的节能模式 (4)

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

Power State Settable (5)

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

支持 (6)

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

支持的计时开机 (7)

可以使用 PowerState 参数设置为 5 (Power Cycle) 和时间设置为特定日期和时间或开机间隔调用 SetPowerState 方法。

PowerManagementSupported

数据类型: 布尔值

访问类型:只读

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

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

ProtocolCode

数据类型: uint8

访问类型:只读

USB 协议代码。

Status

数据类型: 字符串

访问类型:只读

限定符: MaxLen (10) , DisplayName (“Status”)

对象的当前状态。 此属性继承自 CIM_ManagedSystemElement

包括以下值:

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

(“强调 ”)

NonRecover (“NonRecover ”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

StatusInfo

数据类型: uint16

访问类型:只读

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

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

此属性继承自 CIM_LogicalDevice

其他 (1)

未知 (2)

已启用 (3)

禁用 (4)

不适用 (5)

SubclassCode

数据类型: uint8

访问类型:只读

USB 子类代码。

SystemCreationClassName

数据类型: 字符串

访问类型:只读

限定符: 传播 的 (“CIM_SystemCreationClassName“) , CIM_Key

确定系统的创建类名称的范围。

此属性继承自 CIM_LogicalDevice

SystemName

数据类型: 字符串

访问类型:只读

限定符: 传播 的 (“CIM_System名称“) , CIM_Key

确定系统名称的范围。

此属性继承自 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
命名空间
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

CIM_LogicalDevice