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 (Modelo de información común) DE DMTF (Distributed Management Task Force) son las clases primarias en las que se han creado las clases WMI. WMI admite actualmente solo los esquemas de la versión CIM 2.x.

La sintaxis siguiente se simplifica a partir Managed Object Format (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;
};

Members

La clase _ CIM USBDevice tiene estos tipos de miembros:

Métodos

La clase _ USBDevice de CIM 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 | Operational State | 003.5", "MIB. IETF | HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidad y estado del dispositivo.

Esta propiedad se hereda de _ CIM LogicalDevice.

Otros (1)

Desconocido (2)

Energía completa o en ejecución (3)

Energía completa o en ejecución

Advertencia (4)

En prueba (5)

No aplicable (6)

Apagado (7)

Off Line (8)

Fuera de servicio (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 se desconoce su estado exacto.

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 presentar un rendimiento degradado.

Ahorro de energía: en espera (15)

El dispositivo no funciona, pero se podría encender rápidamente.

Ciclo de energía (16)

Ahorro de energía: advertencia (17)

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

En pausa (18)

El dispositivo está en pausa.

No está listo (19)

El dispositivo no está listo.

Sin configurar (20)

El dispositivo no está configurado.

Quiesced (21)

El dispositivo está 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")

Código de error Administrador de configuración Win32.

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 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é quedando sin 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 para este dispositivo necesita un recurso que Windows puede administrar. (5)

El controlador del dispositivo requiere un recurso que Windows 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 informa incorrectamente de los recursos del dispositivo. (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 puede encontrar suficientes recursos gratuitos que pueda usar. (12)

El dispositivo no puede encontrar suficientes recursos gratuitos para usarlos.

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

Windows 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 nueva enumeración. (15)

El dispositivo no funciona correctamente debido a un posible problema de nueva enumeración.

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

Windows 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 dispositivos deben volver a instalarse.

Error al usar el cargador 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 todos sus controladores instalados. (24)

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

Windows está configurando este dispositivo. (25)

Windows está configurando el dispositivo.

Windows está configurando este dispositivo. (26)

Windows está 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 proporcionaba los recursos necesarios.

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

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

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

El dispositivo no funciona correctamente. Windows 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: Clave _ CIM

Nombre de la clase o subclase usada en la creación de una instancia de . Cuando se usa con otras propiedades clave de la clase , esta propiedad permite identificar de forma única 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 ("Description")

Descripción textual del objeto.

Esta propiedad se hereda de CIM _ ManagedSystemElement.

Deviceid

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Clave CIM _

Dirección u otra información de identificación para dar 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 deben 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 subclasifica, 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 especificados automáticamente (4)

El dispositivo puede cambiar su estado de energía 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 _ logicalDevice de CIM primaria y se puede implementar. Para obtener más información, vea Designing Managed Object Format (MOF) Classes.

Power Cycling compatible (6)

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

Encendido con tiempo de encendido admitido (7)

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

PowerManagementSupported

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es TRUE, el dispositivo se puede administrar con energía, es decir, poner en un estado de ahorro de energía. Si es FALSE, el valor entero 1 ("No compatible") 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 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 de pred ("error previo")

A partir de ("Starting")

Detención ("Deteniendo")

Servicio ("Servicio")

Estresado ("estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Comm perdido ("Comm perdido")

StatusInfo

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF | Operational State | 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)

SubclassCode

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 ("Sistema CIM _.CreationClassName"), Clave _ CIM

Nombre de 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 ("Sistema CIM _.Nombre"), Clave _ CIM

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 el segundo y el tercer dígito. 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, vea Clases Win32.

Esta documentación se deriva de las descripciones de clases CIM publicadas por dmtf. Microsoft puede haber realizado cambios para corregir errores menores, ajustarse a 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
\CIMV2 raíz
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

_Dispositivo lógico CIM