Compartilhar via

classe CIM_USBDevice (Provedores WMI CIMWin32)

  • Artigo

A classe CIM_USBDevice representa as características de gerenciamento de um dispositivo USB.

Importante

As classes CIM da DMTF (Força-Tarefa de Gerenciamento Distribuído) (Modelo de Informações Comuns) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão CIM 2.x.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as suas propriedades herdadas. As propriedades são listadas em ordem alfabética, não na ordem MOF.

Sintaxe

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

Membros

A classe CIM_USBDevice tem esses tipos de membros:

Métodos

A classe CIM_USBDevice tem esses métodos.

Método Descrição
GetDescriptor Retorna o descritor do dispositivo USB. Não implementado pelo WMI.
Redefinir Solicita uma redefinição do dispositivo lógico. Não implementado pelo WMI.
SetPowerState Define o estado de energia desejado para um dispositivo lógico e quando um dispositivo deve ser colocado nesse estado. Não implementado pelo WMI.

Propriedades

A classe CIM_USBDevice tem essas propriedades.

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

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

Disponibilidade e status do dispositivo.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Energia em execução/total (3)

Energia completa ou em execução

Aviso (4)

Em Teste (5)

Não aplicável (6)

Desligar (7)

Off Line (8)

Off Duty (9)

Degradado (10)

Não Instalado (11)

Erro de instalação (12)

Power Save - Desconhecido (13)

O dispositivo é conhecido por estar em um modo de economia de energia, mas seu status exato é desconhecido.

Economia de Energia – Modo de Baixa Energia (14)

O dispositivo está em um estado de economia de energia, mas ainda funcionando, e pode exibir desempenho degradado.

Power Save - Standby (15)

O dispositivo não está funcionando, mas pode ser levado a energia total rapidamente.

Power Cycle (16)

Power Save - Aviso (17)

O dispositivo está em um estado de aviso, embora também em um modo de economia de energia.

Pausado (18)

O dispositivo está em pausa.

Não Pronto (19)

O dispositivo não está pronto.

Não Configurado (20)

O dispositivo não está configurado.

Quiesced (21)

O dispositivo está silencioso.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Descrição textual curta do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

ClassCode

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Código de classe USB.

ConfigManagerErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Win32 Configuration Manager código de erro.

Essa propriedade é herdada de CIM_LogicalDevice.

Este dispositivo está funcionando corretamente. (0)

O dispositivo está funcionando corretamente.

Esse dispositivo não está configurado corretamente. (1)

O dispositivo não está configurado corretamente.

Windows não pode carregar o driver para este dispositivo. (2)

O driver desse dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos. (3)

O driver para esse dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos.

Esse dispositivo não está funcionando corretamente. Um de seus drivers ou seu registro pode estar corrompido. (4)

O dispositivo não está funcionando corretamente. Um de seus drivers ou o registro pode estar corrompido.

O driver para este dispositivo precisa de um recurso que Windows não pode gerenciar. (5)

O driver do dispositivo requer um recurso que Windows não pode gerenciar.

A configuração de inicialização desse dispositivo entra em conflito com outros dispositivos. (6)

A configuração de inicialização do dispositivo entra em conflito com outros dispositivos.

Não é possível filtrar. (7)

O carregador do driver para o dispositivo está ausente. (8)

O carregador de driver para o dispositivo está ausente.

Esse dispositivo não está funcionando corretamente porque o firmware de controle está relatando os recursos do dispositivo incorretamente. (9)

O dispositivo não está funcionando corretamente. O firmware de controle está relatando incorretamente os recursos para o dispositivo.

Este dispositivo não pode ser iniciado. (10)

O dispositivo não pode ser iniciado.

Esse dispositivo falhou. (11)

Falha no dispositivo.

Esse dispositivo não pode encontrar recursos gratuitos suficientes que podem ser usados. (12)

O dispositivo não pode encontrar recursos gratuitos suficientes para usar.

Windows não é possível verificar os recursos deste dispositivo. (13)

Windows não é possível verificar os recursos do dispositivo.

Esse dispositivo não pode funcionar corretamente até que você reinicie o computador. (14)

O dispositivo não pode funcionar corretamente até que o computador seja reiniciado.

Esse dispositivo não está funcionando corretamente porque provavelmente há um problema de renumeração. (15)

O dispositivo não está funcionando corretamente devido a um possível problema de renumeração.

Windows não é possível identificar todos os recursos que este dispositivo usa. (16)

Windows não é possível identificar todos os recursos que o dispositivo usa.

Esse dispositivo está solicitando um tipo de recurso desconhecido. (17)

O dispositivo está solicitando um tipo de recurso desconhecido.

Reinstale os drivers para este dispositivo. (18)

Os drivers de dispositivo devem ser reinstalados.

Falha ao usar o carregador VxD. (19)

Seu registro pode estar corrompido. (20)

O Registro pode estar corrompido.

Falha no sistema: tente alterar o driver para este dispositivo. Se isso não funcionar, consulte a documentação do hardware. Windows está removendo este dispositivo. (21)

Falha no sistema. Se a alteração do driver do dispositivo for ineficaz, consulte a documentação de hardware. Windows está removendo o dispositivo.

Esse dispositivo está desabilitado. (22)

O dispositivo está desabilitado.

Falha no sistema: tente alterar o driver para este dispositivo. Se isso não funcionar, consulte a documentação do hardware. (23)

Falha no sistema. Se a alteração do driver do dispositivo for ineficaz, consulte a documentação de hardware.

Esse dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados. (24)

O dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados.

Windows ainda está configurando este dispositivo. (25)

Windows ainda está configurando o dispositivo.

Windows ainda está configurando este dispositivo. (26)

Windows ainda está configurando o dispositivo.

Esse dispositivo não tem configuração de log válida. (27)

O dispositivo não tem configuração de log válida.

Os drivers para este dispositivo não estão instalados. (28)

Os drivers de dispositivo não estão instalados.

Esse dispositivo está desabilitado porque o firmware do dispositivo não lhe deu os recursos necessários. (29)

O dispositivo está desabilitado. O firmware do dispositivo não forneceu os recursos necessários.

Esse dispositivo está usando um recurso IRQ (Solicitação de Interrupção) que outro dispositivo está usando. (30)

O dispositivo está usando um recurso IRQ que outro dispositivo está usando.

Esse dispositivo não está funcionando corretamente porque Windows não pode carregar os drivers necessários para este dispositivo. (31)

O dispositivo não está funcionando corretamente. Windows não pode carregar os drivers de dispositivo necessários.

ConfigManagerUserConfig

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Se VERDADEIRO, o dispositivo está usando uma configuração definida pelo usuário.

Essa propriedade é herdada de CIM_LogicalDevice.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key

Nome da classe ou subclasse usada na criação de uma instância. Quando usada com outras propriedades principais da classe, essa propriedade permite que todas as instâncias da classe e suas subclasses sejam identificadas exclusivamente.

Essa propriedade é herdada de CIM_LogicalDevice.

CurrentAlternateSettings

Tipo de dados: matriz uint8

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_USBDevice. CurrentConfigValue")

Configurações alternativas USB para cada interface na configuração selecionada no momento (indicada pela propriedade CurrentConfigValue ). Essa matriz tem uma entrada para cada interface na configuração. Se a propriedade CurrentConfigValue tiver um valor de 0 (zero), o que indica que o dispositivo não está configurado, a matriz será indefinida. Para obter mais informações sobre a análise dessa cadeia de caracteres de octeto, consulte a especificação USB.

CurrentConfigValue

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_USBDevice. CurrentAlternateSettings")

Configuração atualmente selecionada para o dispositivo. Se o valor for 0 (zero), o dispositivo não será configurado.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key

Endereço ou outras informações de identificação para nomear exclusivamente o dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o erro relatado na propriedade LastErrorCode agora será limpo.

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Cadeia de caracteres de formulário livre que fornece informações sobre o erro registrado na propriedade LastErrorCode e ações corretivas a serem executadas.

Essa propriedade é herdada de CIM_LogicalDevice.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Data e hora em que o objeto foi instalado. Essa propriedade não precisa de um valor para indicar que o objeto está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

LastErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Último código de erro relatado pelo dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Name")

Rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave.

Essa propriedade é herdada de CIM_ManagedSystemElement.

NumberOfConfigs

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Número de configurações de dispositivo definidas para o dispositivo.

PNPDeviceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Win32 Plug and Play identificador de dispositivo do dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice.

Exemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Matriz das funcionalidades específicas relacionadas à energia de um dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Desconhecido (0)

Sem suporte (1)

Desabilitado (2)

Habilitado (3)

Os recursos de gerenciamento de energia estão habilitados no momento, mas o conjunto de recursos exato é desconhecido ou as informações não estão disponíveis.

Modos de economia de energia inseridos automaticamente (4)

O dispositivo pode alterar seu estado de energia com base no uso ou em outros critérios.

Power State Settable (5)

Há suporte para o método SetPowerState . Esse método é encontrado na classe CIM_LogicalDevice pai e pode ser implementado. Para obter mais informações, consulte Como criar classes MOF (Formato de Objeto Gerenciado).

Power Cycling com suporte (6)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 (Power Cycle).

Suporte para o Power On cronometrado (7)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 (Power Cycle) e Tempo definido como uma data e hora específicas, ou intervalo, para ativar.

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o dispositivo pode ser gerenciado por energia, ou seja, colocado em um estado de economia de energia. Se FALSE, o valor inteiro 1 ("Sem Suporte") deverá ser a única entrada na matriz PowerManagementCapabilities .

Essa propriedade não indica se os recursos de gerenciamento de energia estão habilitados no momento ou se estão habilitados, quais recursos têm suporte. Para obter mais informações, consulte a matriz PowerManagementCapabilities . Essa propriedade é herdada de CIM_LogicalDevice.

ProtocolCode

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Código de protocolo USB.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Status atual do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de Pred ("Falha de Pred")

Iniciando ("Iniciando")

Parar ("Parar")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado Operacional|003.3")

Estado do dispositivo lógico. Se essa propriedade não se aplicar ao dispositivo lógico, o valor 5 (Não Aplicável) deverá ser usado.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Habilitado (3)

Desabilitado (4)

Não aplicável (5)

SubclassCode

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Código de subclasse USB.

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Propagado ("CIM_System. CreationClassName"), CIM_Key

Nome da classe de criação do sistema de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Propagado ("CIM_System. Nome"), CIM_Key

Nome do sistema de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

USBVersion

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Versão USB mais recente com suporte do dispositivo USB. Essa propriedade é expressa como um BCD (decimal) codificado em binário, em que um ponto decimal está implícito entre o segundo e o terceiro dígitos. Por exemplo, um valor de 0x201 indica que há suporte para a versão 2.01.

Comentários

A classe CIM_USBDevice é derivada de CIM_LogicalDevice.

O WMI não implementa essa classe. Para classes WMI que implementam CIM_USBDevice, consulte Classes Win32.

Essa documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir pequenos erros, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

CIM_LogicalDevice