Classe CIM_MediaAccessDevice (Provedores WMI CIMWin32)
A classe CIM_MediaAccessDevice representa a capacidade de acessar uma ou mais mídias e, em seguida, usar a mídia para armazenar e recuperar dados.
Importante
As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) 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 propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.
Sintaxe
[Abstract, UUID("{8502C52A-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_MediaAccessDevice : CIM_LogicalDevice
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
uint16 Availability;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string DeviceID;
uint16 PowerManagementCapabilities[];
boolean ErrorCleared;
string ErrorDescription;
uint32 LastErrorCode;
string PNPDeviceID;
boolean PowerManagementSupported;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
uint16 Capabilities[];
string CapabilityDescriptions[];
string CompressionMethod;
uint64 DefaultBlockSize;
string ErrorMethodology;
uint64 MaxBlockSize;
uint64 MaxMediaSize;
uint64 MinBlockSize;
boolean NeedsCleaning;
uint32 NumberOfMediaSupported;
};
Membros
A classe CIM_MediaAccessDevice tem estes tipos de membros:
Métodos
A classe CIM_MediaAccessDevice tem esses métodos.
| Método | Descrição |
|---|---|
| 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_MediaAccessDevice 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/completa (3)
-
Aviso (4)
-
Em Teste (5)
-
Não aplicável (6)
-
Desligar (7)
-
Off Line (8)
-
Desativação do serviço (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 sua status exata é desconhecida.
-
Economia de energia – modo de energia baixa (14)
-
O dispositivo está em um estado de economia de energia, mas ainda está funcionando e pode apresentar desempenho degradado.
-
Power Save – Espera (15)
-
O dispositivo não está funcionando, mas pode ser levado à potência total rapidamente.
-
Ciclo de Energia (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.
Funcionalidades
-
Tipo de dados: matriz uint16
-
Tipo de acesso: Somente leitura
-
Qualificadores: ArrayType ("Indexed"), MappingStrings ("MIF. DMTF| Dispositivos de armazenamento|001.9", "MIF. DMTF| Dispositivos de armazenamento|001.11", "MIF. DMTF| Dispositivos de armazenamento|001.12", "MIF. DMTF| Disks|003.7"), ModelCorrespondence ("CIM_MediaAccessDevice. CapabilityDescriptions")
Funcionalidades do dispositivo de acesso à mídia.
Desconhecido (0)
Desconhecida.
Outros (1)
Outros.
Acesso Sequencial (2)
Acesso sequencial.
Acesso Aleatório (3)
Acesso aleatório.
Dá suporte à gravação (4)
Escrever.
Criptografia (5)
Criptografia.
Compactação (6)
Compactação.
Dá suporte à mídia removível (7)
Mídia removível.
Limpeza Manual (8)
Limpeza manual.
Limpeza automática (9)
Limpeza automática.
Notificação SMART (10)
Notificação SMART.
Dá suporte à mídia dupla lateral (11)
Mídia de lado duplo.
Distingue um dispositivo que pode acessar ambos os lados da mídia de dois lados de um dispositivo que lê apenas um único lado e exige que a mídia seja entregue.
Predismount Eject not Required (12)
Indica que a mídia não precisa ser explicitamente ejetada do dispositivo antes de ser acessada por um elemento seletor.
CapabilityDescriptions
-
Tipo de dados: matriz de cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: ArrayType ("Indexado"), ModelCorrespondence ("CIM_MediaAccessDevice. Funcionalidades")
Matriz de cadeias de caracteres de forma livre que fornece explicações detalhadas para acessar recursos de dispositivo indicados na matriz Funcionalidades .
Observação
Cada entrada dessa matriz está relacionada à entrada na matriz Capabilities , localizada no mesmo índice.
Legenda
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (64), DisplayName ("Caption")
Uma breve descrição textual do objeto.
Essa propriedade é herdada de CIM_ManagedSystemElement.
CompressionMethod
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Cadeia de caracteres de forma livre que indica o algoritmo ou a ferramenta usada para compactar o arquivo lógico. Se não for possível descrever o esquema de compactação (porque é desconhecido), use o seguinte: Se , use "Desconhecido". Se , use "Compactado". , use "Não Compactado".
"Desconhecido"
O esquema de compactação é desconhecido ou não é descrito.
"Compactado"
O arquivo lógico é compactado, mas o esquema de compactação é desconhecido ou não é descrito
"Não compactado"
Se o arquivo lógico não estiver compactado
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. acima (0)
Este dispositivo não está configurado corretamente. (1)
O Windows não pode carregar o driver para este dispositivo. (2)
O driver deste dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos. (3)
Este dispositivo não está funcionando corretamente. Um de seus drivers ou seu registro pode estar corrompido. (4)
O driver deste dispositivo precisa de um recurso que o Windows não possa gerenciar. (5)
A configuração de inicialização deste dispositivo está em conflito com outros dispositivos. (6)
Não é possível filtrar. (7)
O carregador de driver para o dispositivo está ausente. (8)
Este dispositivo não está funcionando corretamente porque o firmware de controle está relatando os recursos para o dispositivo incorretamente. (9)
Este dispositivo não pode ser iniciado. (10)
Este dispositivo falhou. (11)
Este dispositivo não pode encontrar recursos gratuitos suficientes que ele pode usar. (12)
O Windows não pode verificar os recursos deste dispositivo. (13)
Este dispositivo não pode funcionar corretamente até que você reinicie o computador. (14)
Este dispositivo não está funcionando corretamente porque provavelmente há um problema de renumeração. (15)
O Windows não pode identificar todos os recursos que este dispositivo usa. (16)
Este dispositivo está solicitando um tipo de recurso desconhecido. (17)
Reinstale os drivers para este dispositivo. (18)
Falha ao usar o carregador VxD. (19)
Seu registro pode estar corrompido. (20)
Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. O Windows está removendo este dispositivo. (21)
Este dispositivo está desabilitado. (22)
Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. (23)
Este dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados. (24)
O Windows ainda está configurando este dispositivo. (25)
O Windows ainda está configurando este dispositivo. (26)
Este dispositivo não tem uma configuração de log válida. (27)
Os drivers para este dispositivo não estão instalados. (28)
Esse dispositivo está desabilitado porque o firmware do dispositivo não lhe deu os recursos necessários. (29)
Este dispositivo está usando um recurso irq (solicitação de interrupção) que outro dispositivo está usando. (30)
Este dispositivo não está funcionando corretamente porque o Windows não pode carregar os drivers necessários para este dispositivo. (31)
ConfigManagerUserConfig
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
-
Qualificadores: Esquema ("Win32")
Se TRUE, 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 de chave da classe , essa propriedade permite que todas as instâncias da classe e suas subclasses sejam identificadas exclusivamente.
Essa propriedade é herdada de CIM_LogicalDevice.
DefaultBlockSize
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
-
Qualificadores: unidades ("bytes")
Tamanho do bloco padrão, em bytes, para o dispositivo.
Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.
Descrição
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Description")
Uma 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 forma 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.
ErrorMethodology
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Cadeia de caracteres de forma livre que descreve os tipos de detecção e correção de erros compatíveis com o dispositivo.
InstallDate
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")
Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não 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.
MaxBlockSize
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
-
Qualificadores: unidades ("bytes")
Tamanho máximo do bloco, em bytes, para mídia acessada pelo dispositivo.
Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.
MaxMediaSize
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("MIF. DMTF| Dispositivos de acesso sequencial|001.2"), unidades ("quilobytes")
Tamanho máximo, em quilobytes, de mídia compatível com este dispositivo. Os quilobytes são interpretados como o número de bytes multiplicado por 1000 (não o número de bytes multiplicado por 1024).
Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.
MinBlockSize
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
-
Qualificadores: unidades ("bytes")
Tamanho mínimo do bloco, em bytes, para mídia acessada pelo dispositivo.
Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.
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.
NeedsCleaning
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Se TRUE, o dispositivo de acesso à mídia precisará ser limpo. Se a limpeza manual ou automática é possível, é indicado na propriedade de matriz Capabilities .
NumberOfMediaSupported
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Número máximo de várias mídias individuais que podem ser suportadas ou inseridas.
PNPDeviceID
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: Esquema ("Win32")
Indica o win32 Plug and Play identificador de dispositivo do dispositivo lógico.
Exemplo: "*PNP030b"
Essa propriedade é herdada de CIM_LogicalDevice.
PowerManagementCapabilities
-
Tipo de dados: matriz uint16
-
Tipo de acesso: Somente leitura
Indica os recursos específicos relacionados à energia do dispositivo lógico.
Essa propriedade é herdada de CIM_LogicalDevice.
Desconhecido (0)
As capacidades relacionadas à energia são desconhecidas.
Sem suporte (1)
Capacidades relacionadas à energia não têm suporte para este dispositivo.
Desabilitado (2)
As capacidades relacionadas à energia foram desabilitadas.
Habilitado (3)
Os recursos de gerenciamento de energia estão habilitados no momento, mas o conjunto exato de recursos é 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 de CIM_LogicalDevice pai e pode ser implementado. Para obter mais informações, consulte Criando 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").
Com suporte para Ligar /Hora (7)
O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 ("Power Cycle") e o parâmetro Time definido como uma data e hora específicas, ou intervalo, para ativação.
PowerManagementSupported
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Se TRUE, o dispositivo poderá 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 atualmente habilitados 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.
Status
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (10), DisplayName ("Status")
Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).
As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.
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")
Parando ("Parando")
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)
SystemCreationClassName
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: Propagado ("CIM_System. CreationClassName"), CIM_Key
O 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
O nome do sistema de escopo.
Essa propriedade é herdada de CIM_LogicalDevice.
Comentários
A classe CIM_MediaAccessDevice é derivada de CIM_LogicalDevice.
O WMI não implementa essa classe. Para classes derivadas de CIM_MediaAccessDevice, consulte Classes Win32.
Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, 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 |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de