Retour à la table des matières
Classes de diagnostic
Entrées du registre
Consignation au journal
Classes d'association
Tests
Objectif
IANet_DiagTest est une sous-classe de CIM_DiagnosticTest.
La classe offre une plate-forme générique pour exécuter et contrôler les tests de diagnostic d'une carte Ethernet prise en charge par Intel® PROSet. La superclasse, CIM_DiagnosticTest, est conçue pour prendre en charge de manière générale les tests de tout matériel informatique sur un système compatible CIM. Les propriétés de la classe sont descriptives par nature et les systèmes de test sont fournis par les méthodes exposées.
Instances
La clé est Name, et dans ce fournisseur, il s'agit de la concaténation d'un index numérique du test du GUID de la carte référencée (p. ex., 1@{12345678-9ABC-DEF0-1234-123456789012}). La valeur de la clé est d'une certaine manière une information redondante, car toutes les informations de référence de carte et de test sont passées en tant que paramètres d'objet dans RunTest, ainsi que dans d'autres méthodes. Malgré cela, l'instance doit être cohérente avec les paramètres de la méthode sinon le fournisseur rejette la commande. La propriété Caption fournit le nom du test que cette instance va exécuter. D'autres propriétés offrent une description et des informations sur l'exécution.
Création d'instances
Vous ne pouvez pas créer des instances de IANet_DiagTest.
Suppression d'instances
Vous ne pouvez pas supprimer des instances de IANet_DiagTest.
Modification des propriétés
Aucune propriété de cette classe ne peut être modifiée par l'utilisateur.
Associations
Propriétés non prises en charge
Install Date, OtherCharacteristicDescription
Méthodes
Cette classe prend en charge les méthodes suivantes :
Hiérarchie des classes
Pour CimV2. Les propriétés et les méthodes inutilisées ne sont pas affichées.
La méthode RunTest du fichier MOF se présente comme suit :
uint32
RunTest([IN] CIM_ManagedSystemElement ref SystemElement,
[IN] CIM_DiagnosticSetting ref Setting,
[OUT] CIM_DiagnosticResult ref Result);
Les deux premiers paramètres sont des paramètres d'entrée. Vous devez obtenir le chemin des deux objets référencés. Vous devez également obtenir le chemin de l'objet IANet_DiagTest qui exporte l'objet 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}"Objectif
Les instances de IANet_DiagSetting fournissent des directives d'exécution spécifiques des tests de diagnostic. Les directives utilisées sont communes à tous les tests et sont liées à la superclasse CIM_DiagnosticSetting. Elles comprennent des propriétés comme ReportSoftErrors et HaltOnError. Aucune autre propriété n'est ajoutée à la sous-classe IANet_DiagSetting.
Création d'instances
Vous ne pouvez pas créer des instances de cette classe.
Suppression d'instances
Vous ne pouvez pas supprimer des instances de cette classe.
Modification des propriétés
UpdateInstanceAsync est mis en oeuvre et peut être utilisé pour définir les paramètres de test sur "Halt On Error", "Report Soft Errors", "Report Status Messages", "Quick Mode", "Test Warning Level" et "Percent Of Test Coverage".
Associations
Une instance de IANetDiagSettingForTest associe un IANet_DiagTest avec un IANet_DiagSetting.
Propriétés non prises en charge
Les propriétés suivantes ne sont pas prises en charge par NCS :
Méthodes
Aucune
Hiérarchie des classes
Pour CimV2. Les propriétés et les méthodes inutilisées ne sont pas affichées.
Objectif
Les instances de IANet_DiagResult affichent les données des résultats d'une exécution de test particulière sur une carte spécifique. Les instances de cette classe correspondent exactement aux instances de IANet_DiagTest et de IANet_DiagSetting.
Instances
Les instances de IANet_DiagResult correspondent aux résultats d'une exécution de test particulière sur une carte spécifique. Le format de la clé est identique à IANet_DiagTest et IANet_DiagSetting. L'instance peut stocker tout résultat de test arbitraire, et toute donnée ne correspondant pas aux propriétés définies peut être placée dans la propriété du tableau TestResults. Chaque fois qu'un test est exécuté sur une carte, la nouvelle instance remplace l'instance existante des résultats du test correspondant à cette combinaison carte/test.
Création d'instances
Vous ne pouvez pas créer des instances de cette classe.
Suppression d'instances
Vous ne pouvez pas supprimer des instances de cette classe.
Modification d'instances
Vous ne pouvez pas modifier les instances de cette classe.
Associations
Une instance de IANet_DiagResultForTest associe un IANet_DiagTest avec une instance IANet_DiagnosticResult.
Propriétés non prises en charge
Les propriétés suivantes ne sont pas prises en charge par NCS :
Méthodes
Aucune
Hiérarchie des classes
Pour CimV2. Les propriétés et les méthodes inutilisées ne sont pas affichées.
Les entrées suivantes sont entrées dans le registre pendant l'installation sous HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag. Ces clés et valeurs contrôlent l'exécution des tests de diagnostic et sont définies ci-dessous.
La table suivante contient les valeurs et les types de clés, ainsi qu'une brève explication sur leur utilisation :
| Valeur | Type | Valeur par défaut | Utilisation |
| Check Time | REG_DWORD | 2 secondes | Délai entre les vérifications de l'exécution du test envoyeur/répondeur |
| Enable | REG_DWORD | 0 | Activer (1) ou Désactiver (0) l'utilisation d'un fichier journal de résultats. |
| FileAppend | REG_DWORD | 1 | Annexer (1) le fichier journal des résultats à un fichier journal existant. Si 0, le fichier existant est remplacé. |
| LogFileName | REG_SZ | NcsDiag.log | Le nom du fichier journal de résultats. |
| MaxFileSize | REG_DWORD | 0x10000 | La taille maximale du fichier journal de résultats. |
| MaxPktsRcvd | REG_DWORD | 200 | En mode rapide (Quick Mode de IANet_DiagSetting), le test envoyer/recevoir s'arrête lorsque le nombre de paquets reçus est supérieur à cette valeur. |
| TimeoutSndRsp | REG_DWORD | 100 | Le test s'arrête lorsque sa durée (en secondes) dépasse cette valeur. |
Le journal des résultats affiche principalement des informations qui peuvent être également obtenues à partir des objets IANet_DiagResult. La différence est que les informations obtenues d'un navigateur CIM n'affichent que les derniers résultats immédiats de tests particuliers sur une carte particulière. Les tests suivants remplacent les résultats des tests précédents. Le journal des résultats est plus pratique pour configurer et afficher plusieurs exécutions de tels tests.
Pour activer le journal des résultats :
| Classe d'association | Propriété/valeur de référence | Propriété/valeur de référence |
| 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 |
Les tests mis en oeuvre peuvent être exécutés sur un ou deux ordinateurs. Les descriptions détaillées des tests ne sont pas incluses dans ce document, car le fournisseur CDM est prévu pour être une plate-forme de test générique non dépendante des caractéristiques des tests. Cependant, une certaine dépendance expliquée dans cette section existe dans le code.
Les tests suivants sont exécutés sur une carte unique et ne nécessitent aucune interaction avec une autre carte :
Tous les messages d'erreur de ces tests sont le résultat des codes d'erreur HRESULT renvoyés des appels vers les couches de piles inférieures. Les codes d'erreur sont stockés intérieurement sous forme de codes d'erreur, et ils ne sont pas traduits en messages d'erreur jusqu'à ce que les objets IANet_DiagResult soient déréférencés par énumération, ou que des appels d'objet soient réceptionnés par une application de gestion.
Les tests envoyeur/répondeur sont des tests interdépendants au cours desquels une carte (envoyeur) envoie des paquets à une autre carte (répondeur) qui, à son tour, renvoie les paquets à l'envoyeur pour fermer la boucle. Ces tests sont identiques et peuvent être exécutés à partir d'Intel® PROSet. Cependant, Intel PROSet n'utilise pas CDM et ne permet pas d'exécuter deux tests simultanément sur le même ordinateur. CDM permet l'exécution simultanée de différents tests sur un même ordinateur.
Le test envoyeur/répondeur requiert deux cartes Intel (1 envoyeur et 1 répondeur). Ce test est le seul qui soit exécuté sur la base d'un second thread qui est actif jusqu'à ce que le test s'arrête suivant des critères définis ou que le test soit arrêté par le premier thread. Les critères d'achèvement du test sont des temporisations basées sur la durée du test ou sur le nombre de paquets reçus. Ces deux valeurs sont obtenues à partir du registre. Le test ne peut se terminer en fonction du nombre de paquets reçus que si le mode rapide (Quick Mode) a été activé. Ce mode est une propriété de la classe IANet_DiagSetting et peut donc être défini pour chaque carte. Les répondeurs CDM répondent aux répondeurs PROSet et vice versa.
Deux types de valeurs d'erreur sont renvoyés par les tests envoyeur/répondeur. Tout d'abord, un code d'erreur (HRESULT) peut être renvoyé par les couches inférieures. Ensuite, le thread du test renvoie des statistiques intermédiaires et finales pendant l'exécution du test, sauf si le test est terminé prématurément en raison d'un code d'erreur renvoyé. Les statistiques comprennent :
Veuillez lire toutes les restrictions et clauses exonératoires de responsabilité.