CIM_USBDevice clase (proveedores WMI CIMWin32)

La clase CIM_USBDevice representa las características de administración de un dispositivo USB.

Importante

Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.

La sintaxis siguiente se simplifica desde el código de Formato de objeto administrado (MOF) e incluye todas sus propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

[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;
};

Miembros

La clase CIM_USBDevice tiene estos tipos de miembros:

Métodos

La clase CIM_USBDevice tiene estos métodos.

Método Descripción
GetDescriptor Devuelve el descriptor del dispositivo USB. No implementado por WMI.
Reset Solicita un restablecimiento del dispositivo lógico. No implementado por WMI.
SetPowerState Define el estado de energía deseado para un dispositivo lógico y cuándo se debe colocar un dispositivo en ese estado. No implementado por WMI.

Propiedades

La clase CIM_USBDevice tiene estas propiedades.

Disponibilidad

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| Estado operativo|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidad y estado del dispositivo.

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Corriente/potencia completa (3)

Ejecución o energía completa

Advertencia (4)

En prueba (5)

No aplicable (6)

Apagar (7)

Off Line (8)

Off Duty (9)

Degradado (10)

No instalado (11)

Error de instalación (12)

Ahorro de energía- Desconocido (13)

Se sabe que el dispositivo está en modo de ahorro de energía, pero su estado exacto es desconocido.

Ahorro de energía- Modo de bajo consumo (14)

El dispositivo está en un estado de ahorro de energía, pero sigue funcionando, y puede mostrar un rendimiento degradado.

Ahorro de energía : en espera (15)

El dispositivo no funciona, pero se podría llevar a toda la potencia rápidamente.

Ciclo de alimentación (16)

Ahorro de energía- Advertencia (17)

El dispositivo está en un estado de advertencia, aunque también en modo de ahorro de energía.

En pausa (18)

El dispositivo está en pausa.

No listo (19)

El dispositivo no está listo.

Sin configurar (20)

El dispositivo no está configurado.

En modo in quiesco (21)

El dispositivo es silencioso.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), DisplayName ("Caption")

Breve descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

ClassCode

Tipo de datos: uint8

Tipo de acceso: solo lectura

Código de clase USB.

ConfigManagerErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Win32 Configuration Manager código de error.

Esta propiedad se hereda de CIM_LogicalDevice.

Este dispositivo funciona correctamente. (0)

El dispositivo funciona correctamente.

Este dispositivo no está configurado correctamente. (1)

El dispositivo no está configurado correctamente.

Windows no puede cargar el controlador para este dispositivo. (2)

Es posible que el controlador de este dispositivo esté dañado o que el sistema se esté ejecutando poco en memoria u otros recursos. (3)

Es posible que el controlador de este dispositivo esté dañado o que el sistema tenga poca memoria u otros recursos.

Este dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados. (4)

El dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados.

El controlador de este dispositivo necesita un recurso que Windows no puede administrar. (5)

El controlador para el dispositivo requiere un recurso que Windows no puede administrar.

La configuración de arranque de este dispositivo entra en conflicto con otros dispositivos. (6)

La configuración de arranque del dispositivo entra en conflicto con otros dispositivos.

No se puede filtrar. (7)

Falta el cargador de controladores para el dispositivo. (8)

Falta el cargador de controladores para el dispositivo.

Este dispositivo no funciona correctamente porque el firmware de control notifica los recursos del dispositivo incorrectamente. (9)

El dispositivo no funciona correctamente. El firmware de control informa incorrectamente de los recursos del dispositivo.

Este dispositivo no se puede iniciar. (10)

El dispositivo no se puede iniciar.

Error en este dispositivo. (11)

Error en el dispositivo.

Este dispositivo no encuentra suficientes recursos gratuitos que puede usar. (12)

El dispositivo no encuentra suficientes recursos gratuitos para usar.

Windows no puede comprobar los recursos de este dispositivo. (13)

Windows no puede comprobar los recursos del dispositivo.

Este dispositivo no puede funcionar correctamente hasta que reinicie el equipo. (14)

El dispositivo no puede funcionar correctamente hasta que se reinicie el equipo.

Este dispositivo no funciona correctamente porque probablemente haya un problema de volver a enumerar. (15)

El dispositivo no funciona correctamente debido a un posible problema de volver a enumerar.

Windows no puede identificar todos los recursos que usa este dispositivo. (16)

Windows no puede identificar todos los recursos que usa el dispositivo.

Este dispositivo solicita un tipo de recurso desconocido. (17)

El dispositivo solicita un tipo de recurso desconocido.

Vuelva a instalar los controladores de este dispositivo. (18)

Los controladores de dispositivo deben reinstalarse.

Error al usar el cargador de VxD. (19)

Es posible que el registro esté dañado. (20)

El registro puede estar dañado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. Windows está quitando este dispositivo. (21)

Error del sistema. Si cambiar el controlador de dispositivo no es eficaz, consulte la documentación de hardware. Windows está quitando el dispositivo.

Este dispositivo está deshabilitado. (22)

El dispositivo está deshabilitado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. (23)

Error del sistema. Si cambiar el controlador de dispositivo no es eficaz, consulte la documentación de hardware.

Este dispositivo no está presente, no funciona correctamente o no tiene instalados todos sus controladores. (24)

El dispositivo no está presente, no funciona correctamente o no tiene instalados todos sus controladores.

Windows sigue configurando este dispositivo. (25)

Windows sigue configurando el dispositivo.

Windows sigue configurando este dispositivo. (26)

Windows sigue configurando el dispositivo.

Este dispositivo no tiene una configuración de registro válida. (27)

El dispositivo no tiene una configuración de registro válida.

Los controladores de este dispositivo no están instalados. (28)

Los controladores de dispositivo no están instalados.

Este dispositivo está deshabilitado porque el firmware del dispositivo no le ha dado los recursos necesarios. (29)

El dispositivo está deshabilitado. El firmware del dispositivo no proporcionó los recursos necesarios.

Este dispositivo usa un recurso de solicitud de interrupción (IRQ) que usa otro dispositivo. (30)

El dispositivo usa un recurso IRQ que otro dispositivo está usando.

Este dispositivo no funciona correctamente porque Windows no puede cargar los controladores necesarios para este dispositivo. (31)

El dispositivo no funciona correctamente. Windows no puede cargar los controladores de dispositivo necesarios.

ConfigManagerUserConfig

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Si es TRUE, el dispositivo usa una configuración definida por el usuario.

Esta propiedad se hereda de CIM_LogicalDevice.

CreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: CIM_Key

Nombre de la clase o subclase usada en la creación de una instancia. Cuando se usa con otras propiedades clave de la clase , esta propiedad permite identificar todas las instancias de la clase y sus subclases.

Esta propiedad se hereda de CIM_LogicalDevice.

CurrentAlternateSettings

Tipo de datos: matriz uint8

Tipo de acceso: solo lectura

Calificadores: ModelCorrespondence ("CIM_USBDevice. CurrentConfigValue")

Configuración alternativa USB para cada interfaz de la configuración seleccionada actualmente (indicada por la propiedad CurrentConfigValue ). Esta matriz tiene una entrada para cada interfaz de la configuración. Si la propiedad CurrentConfigValue tiene un valor de 0 (cero), lo que indica que el dispositivo no está configurado, la matriz no está definida. Para obtener más información sobre el análisis de esta cadena de octeto, consulte la especificación USB.

CurrentConfigValue

Tipo de datos: uint8

Tipo de acceso: solo lectura

Calificadores: ModelCorrespondence ("CIM_USBDevice. CurrentAlternateSettings")

Configuración seleccionada actualmente para el dispositivo. Si el valor es 0 (cero), el dispositivo no está configurado.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Deviceid

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: CIM_Key

Dirección u otra información de identificación para asignar un nombre único al dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorCleared

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es TRUE, ahora se borra el error notificado en la propiedad LastErrorCode .

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorDescription

Tipo de datos: cadena

Tipo de acceso: solo lectura

Cadena de forma libre que proporciona información sobre el error registrado en la propiedad LastErrorCode y las acciones correctivas que se van a realizar.

Esta propiedad se hereda de CIM_LogicalDevice.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Fecha y hora en que se instaló el objeto. Esta propiedad no necesita un valor para indicar que el objeto está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

LastErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Último código de error notificado por el dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Name")

Etiqueta por la que se conoce el objeto. Cuando se subclase, esta propiedad se puede invalidar para que sea una propiedad de clave.

Esta propiedad se hereda de CIM_ManagedSystemElement.

NumberOfConfigs

Tipo de datos: uint8

Tipo de acceso: solo lectura

Número de configuraciones de dispositivo definidas para el dispositivo.

PNPDeviceID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Win32 Plug and Play identificador de dispositivo del dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice.

Ejemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Matriz de las funcionalidades específicas relacionadas con la energía de un dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Desconocido (0)

No compatible (1)

Deshabilitado (2)

Habilitado (3)

Las características de administración de energía están habilitadas actualmente, pero el conjunto de características exacto es desconocido o la información no está disponible.

Modos de ahorro de energía introducidos automáticamente (4)

El dispositivo puede cambiar su estado de alimentación en función del uso u otros criterios.

Power State Settable (5)

Se admite el método SetPowerState . Este método se encuentra en la clase primaria CIM_LogicalDevice y se puede implementar. Para obtener más información, vea Diseñar clases de formato de objeto administrado (MOF).

Power Cycle Supported (6)

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 (Ciclo de energía).

Encendido con tiempo admitido (7)

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 (ciclo de energía) y tiempo establecido en una fecha y hora específicas, o intervalo, para el encendido.

PowerManagementSupported

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es TRUE, el dispositivo se puede administrar con energía, es decir, colocarlo en un estado de ahorro de energía. Si es FALSE, el valor entero 1 ("No admitido") debe ser la única entrada de la matriz PowerManagementCapabilities .

Esta propiedad no indica si las características de administración de energía están habilitadas actualmente o si están habilitadas, qué características se admiten. Para obtener más información, consulte la matriz PowerManagementCapabilities . Esta propiedad se hereda de CIM_LogicalDevice.

ProtocolCode

Tipo de datos: uint8

Tipo de acceso: solo lectura

Código de protocolo USB.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (10), DisplayName ("Status")

Estado actual del objeto. Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

StatusInfo

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| Estado operativo|003.3")

Estado del dispositivo lógico. Si esta propiedad no se aplica al dispositivo lógico, se debe usar el valor 5 (no aplicable).

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Habilitado (3)

Deshabilitado (4)

No aplicable (5)

SubclaseCode

Tipo de datos: uint8

Tipo de acceso: solo lectura

Código de subclase USB.

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. CreationClassName"), CIM_Key

Nombre de la clase de creación del sistema de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. Nombre"), CIM_Key

Nombre del sistema de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

USBVersion

Tipo de datos: uint16

Tipo de acceso: solo lectura

Versión USB más reciente compatible con el dispositivo USB. Esta propiedad se expresa como un decimal codificado binario (BCD) donde un separador decimal está implícito entre los dígitos segundo y tercero. Por ejemplo, un valor de 0x201 indica que se admite la versión 2.01.

Observaciones

La clase CIM_USBDevice se deriva de CIM_LogicalDevice.

WMI no implementa esta clase. Para las clases WMI que implementan CIM_USBDevice, consulte Clases Win32.

Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación del SDK de Microsoft o proporcionar más información.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Espacio de nombres
Root\CIMV2
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM_LogicalDevice