Classes de diagnósticos
Entradas de registro
Registro
Classes associativas
Testes
Objetivo
IANet_DiagTest é uma subclasse de CIM_DiagnosticTest. Essa classe proporciona um veículo genérico para executar e controlar testes de diagnóstico para um adaptador Ethernet com suporte para Intel® PROSet. A superclasse, CIM_DiagnosticTest, é projetada para suportar genericamente o teste de qualquer tipo de hardware em um sistema habilitado para CIM. As propriedades da classe são de natureza descritiva e a mecânica do teste é fornecida pelos métodos expostos.
Instâncias
A chave é Name (Nome) e, nesse provedor, é a concatenação de um índice numérico do teste no GUID do adaptador referenciado (exemplo: 1@{12345678-9ABC-DEF0-1234-123456789012}). Esse valor de chave é, de certa forma, uma informação redundante, já que todas as informações para referenciar um adaptador e testar são passadas como parâmetros de objeto para RunTest e outros métodos. Mesmo assim, a instância deve ser consistente com os parâmetros do método; caso contrário, o provedor não aceita o comando. A propriedade de legenda (caption) dá o nome do teste que a instância irá executar. Outras propriedades fornecem outras descrições e informações de tempo de execução.
Criação de instâncias
Não é possível criar instâncias de IANet_DiagTest.
Exclusão de instâncias
Não é possível excluir instâncias de IANet_DiagTest.
Modificação de propriedades
Não há propriedades modificáveis pelo usuário para essa classe.
Associaçõe
Propriedades sem suporte
Install Date, OtherCharacteristicDescription
Métodos
Essa classe suporta os seguintes métodos:
Hierarquia de classe
Para CimV2. Propriedades que não foram usadas e métodos não exibidos.
O método RunTest do arquivo MOF é o seguinte:
uint32
RunTest([IN] CIM_ManagedSystemElement ref SystemElement,
[IN] CIM_DiagnosticSetting ref Setting,
[OUT] CIM_DiagnosticResult ref Result);
Os primeiros dois parâmetros são parâmetros In. É necessário obter o caminho de objeto de ambos os objetos referenciados. Também é necessário obter o caminho de objeto de IANet_DiagTest, que está exportando o objeto RunTest.
IANet_DiagTest.\\MYCOMPUTER\root\Cimv2:IANet_DiagTest.Name="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"IANet_EthernetAdapter.\\MYCOMPUTER\root\cimv2:IANet_EthernetAdapter.DeviceID="{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"IANet_DiagSetting.\\MYCOMPUTER\root\cimv2:IANet_DiagSetting.SettingID="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"Objetivo
Instâncias de IANet_DiagSetting fornecem diretivas específicas de teste de diagnóstico em tempo de execução. Todos os testes usam as mesmas diretivas, e elas estão vinculadas à superclasse CIM_DiagnosticSetting. Envolvem propriedades, como ReportSoftErrors e HaltOnError. Não há propriedades adicionais acrescentadas á subclasse IANet_DiagSetting.
Criação de instâncias
Não é possível criar instâncias dessa classe.
Exclusão de instâncias
Não é possível excluir instâncias dessa classe.
Modificação de propriedades
UpdateInstanceAsync é implementado e pode ser usado para configurar os parâmetros de teste como "Halt On Error", "Report Soft Errors", "Report Status Messages", "Quick Mode", "Test Warning Level" e "Percent Of Test Coverage".
Associações
Uma instância de IANetDiagSettingForTest associa uma IANet_DiagTest com um IANet_DiagSetting.
Propriedades sem suporte
O NCS não presta suporte às seguintes propriedades:
Métodos
Nenhum
Hierarquia de classe
Para CimV2. Propriedades que não foram usadas e métodos não exibidos.
Objetivo
Instâncias de IANet_DiagResult exibem os dados de resultado de um determinado teste, executado em um adaptador determinado. As instâncias dessa classe são idênticas às instâncias de IANet_DiagTest e IANet_DiagSetting.
Instâncias
Instâncias de IANet_DiagResult correspondem aos resultados de um determinado teste, executado em um adaptador específico. O formato da chave é o mesmo de IANet_DiagTest e IANet_DiagSetting. A instância pode armazenar qualquer resultado de teste arbitrário como qualquer tipo de dados. Os que não se enquadram nas propriedades definidas, podem ser colocados na propriedade TestResults Array. A qualquer momento que um novo teste é executado no adaptador, a nova instância sobrescreve a instância de resultados de teste já existente que corresponde à combinação de adaptador e teste.
Criação de instâncias
Não é possível criar instâncias dessa classe.
Exclusão de instâncias
Não é possível excluir instâncias dessa classe.
Modificação de propriedades
Não é possível modificar instâncias dessa classe.
Associações
Uma instância de IANet_DiagResultForTest associa uma IANet_DiagTest com uma instância de IANet_DiagnosticResult.
Propriedades sem suporte
O NCS não presta suporte às seguintes propriedades:
Métodos
Nenhum
Hierarquia de classe
Para CimV2. Propriedades que não foram usadas e métodos não exibidos.
As entradas a seguir são inseridas do registro (registry) durante a instalação, em: HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag. Essas chaves e valores controlam a execução dos testes de diagnóstico e são definidos abaixo.
A tabela a seguir contém os valores da chave, o tipo e uma breve explicação sobre o uso:
| Valor | Tipo | Padrão | Uso |
| Check Time | REG_DWORD | 2 seconds | Duração do período entre as verificações, para fazer o teste do emissor ou respondedor. |
| Enable | REG_DWORD | 0 | Habilita (1) ou Desabilita (0) o uso de um arquivo de registro de resultados. |
| FileAppend | REG_DWORD | 1 | Anexa (1) o arquivo de registro de resultados arquivo de registro de resultados já existente. Se 0, exclui o arquivo existente. |
| LogFileName | REG_SZ | NcsDiag.log | O nome do arquivo de registro de resultados. |
| MaxFileSize | REG_DWORD | 0x10000 | O tamanho máximo do arquivo de registro de resultados. |
| MaxPktsRcvd | REG_DWORD | 200 | No Quick Mode (de IANet_DiagSetting), o teste de emissão/recepção termina quando o número de pacotes recebidos é maior que esse valor. |
| TimeoutSndRsp | REG_DWORD | 100 | O teste termina quando a duração dele (em segundos) exceder esse valor. |
O Registro de Resultados mostra principalmente as informações, que também podem ser obtidas de objetos IANet_DiagResult. A diferença é que as informações obtidas de um navegador CIM só mostram os últimos resultados imediatos de determinados testes em um determinado adaptador. Os testes seguintes sobrescrevem os resultados de testes anteriores. O Log de resultados é mais conveniente para configurar e visualizar várias execuções desse teste.
Para habilitar o log de resultados:
| Classe associativa | Propriedade de referência/valor | Propriedade de referência/valor |
| IANet_DiagTestForMSE | Antecedent = IANet_DiagTest | Dependent = IANet_EthernetAdapter |
| IANet_DiagResultForTest | DiagnosticResult = IANet_DiagResult | DiagnosticTest = IANet_DiagTest |
| IANet_DiagSettingForTest | Element = IANet_DiagTest | Setting = IANet_DiagSetting |
| IANet_DiagResultForTest | DiagnosticResult = IANetDiagResult | DiagnosticTest = IANet_DiagTest |
Os testes implementados podem ser executados em uma ou em duas máquinas. Este documento não se destina a dar explicações detalhadas sobre os testes, já que o CDM Provider se destina a ser um veículo genérico de teste, independente das particularidades dos testes. Entretanto, o código gera uma certa dependência e isso será explicado nesta seção.
Os testes a seguir são executados em um único adaptador e não precisam interagir com nenhum outro adaptador:
Todas as mensagens de erro desses testes são resultado de códigos de erro HRESULT retornados de chamadas a camadas mais baixas da pilha. Os códigos de erro são armazenados internamente como códigos de erro e não traduzidos em mensagens de erro até que os objetos IANet_DiagResult sejam "desreferenciados" por enumeração ou sejam recebidas chamadas de objetos de uma aplicação de gerenciamento.
Os testes de emissor e respondedor são dependentes entre si. Um adaptador (o emissor) envia pacotes a outro adaptador (o respondedor) e este envia pacotes ao emissor, fechando o circuito. Esses testes são os mesmos que podem ser executados no Intel ® PROSet. Porém, o Intel PROSet não usa CDM e não permite executar dois testes na mesma máquina ao mesmo tempo. O CDM permite que testes diferentes sejam executados simultaneamente na mesma máquina.
Emissor/respondedor exige dois adaptadores Intel: uma para ser o emissor e um para ser o respondedor. Esse teste é o único a ser executado baseando-se em um segundo thread qye continua executando até que o teste termine de acordo com os critérios de término ou seja interrompido pelo thread primário. Os critérios de término são tempos de espera baseados no período de duração do teste ou no número de pacotes recebidos. Esses dois valores são obtidos no registro. O teste só poderá ser terminado com base no número de pacotes recebidos se o modo Quick for ativado. Quick Mode é uma propriedade da classe IANet_DiagSetting e, portanto, pode ser configurado adaptador por adaptador. Os respondedores CDM responderão a dispositivos PROSet e vice-versa.
Os testes de emissor/respondedor retornam dois tipos de valores de erro. Primeiramente, as camadas inferiores podem retornar um código de erro (HRESULT). Em segundo lugar, enquanto o teste está sendo executado (e se não for terminado prematuramente pelo retorno de um código de erro), o thread do teste retornará as estatísticas parciais e, em seguida, finais do teste, que conterão o seguinte:
Leia todas as restrições e isenções de responsabilidade.