Diagnose-Klassen
Registrierungseinträge
Protokollieren
Assoziative Klassen
Tests
Zweck
IANet_DiagTest gehört einer Unterklasse von CIM_DiagnosticTest an. Die Klasse bietet eine generelle Plattform für das Ausführen und Steuern von Diagnosetests für einen von Intel® PROSet unterstützten Ethernet-Adapter. Die Überklasse CIM_DiagnosticTest ist so gestaltet, dass sie das Testen beliebiger Computerhardware auf einem CIM-aktivierten System unterstützt. Die Eigenschaften der Klasse sind von deskriptiver Art und der Testmechanismus wird von den exponierten Methoden bereitgestellt.
Instanzen
Der Schlüssel ist der Name, und bei diesem Provider handelt es sich um die Konkatenation des numerischen Testindex an der GUID für den Referenzadapter (z. B. 1@{12345678-9ABC-DEF0-1234-123456789012}). Dieser Schlüsselwert stellt in gewissem Sinn eine redundante Information dar, da alle Informationen für das Referenzieren eines Adapters und Tests als Objektparameter an RunTest und andere Methoden übertragen werden. Die Instanz muss jedoch mit den Parametern konsistent sein, da der Provider den Befehl andernfalls ablehnt. In der Untertitel-Eigenschaft wird der Name des Tests angegeben, der von dieser Instanz ausgeführt wird. Andere Eigenschaftsfelder enthalten weitere Beschreibungen und Runtime-Informationen.
Erstellen von Instanzen
Sie können keine Instanzen von IANet_DiagTest erstellen.
Löschen von Instanzen
Sie können keine Instanzen von IANet_DiagTest löschen.
Ändern von Eigenschaften
Für diese Klasse sind keine durch den Benutzer veränderbaren Eigenschaften vorhanden.
Assoziationen
Nicht unterstützte Eigenschaften
Install Date, OtherCharacteristicDescription
Methoden
Diese Klasse unterstützt die folgenden Methoden:
Klassenhierarchie
Für CimV2. Unbenutzte Eigenschaften und Methoden werden nicht aufgeführt.
Die RunTest-Methode aus der MOF-Datei sieht folgendermaßen aus:
uint32
RunTest([IN] CIM_ManagedSystemElement ref SystemElement,
[IN] CIM_DiagnosticSetting ref Setting,
[OUT] CIM_DiagnosticResult ref Result);
Die ersten beiden Parameter kennzeichnen In-Parameter. Sie müssen den Objektpfad für beide referenzierten Objekte ermitteln. Außerdem benötigen Sie den Objektpfad für das IANet_DiagTest-Objekt, das das RunTest-Objekt exportiert.
IANet_DiagTest ein.\\MYCOMPUTER\root\Cimv2:IANet_DiagTest.Name="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"IANet_EthernetAdapter ein.\\MYCOMPUTER\root\cimv2:IANet_EthernetAdapter.DeviceID="{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"IANet_DiagSetting ein.\\MYCOMPUTER\root\cimv2:IANet_DiagSetting.SettingID="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"Zweck
Instanzen von IANet_DiagSetting stellen spezifische Anweisungen für Runtime-Diagnosetests bereit. Die verwendeten Anweisungen gelten für alle Tests und sind an die Überklasse CIM_DiagnosticSetting gebunden. Dazu gehören Eigenschaften wie beispielsweise ReportSoftErrors und HaltOnError. Der Unterklasse IANet_DiagSetting werden keine zusätzlichen Eigenschaften hinzugefügt.
Erstellen von Instanzen
Sie können keine Instanzen dieser Klasse erstellen.
Löschen von Instanzen
Sie können keine Instanzen dieser Klasse löschen.
Ändern von Eigenschaften
UpdateInstanceAsync wird implementiert und kann zum Einstellen von folgenden Testparametern verwendet werden: "Halt On Error" (Bei Fehler anhalten), "Report Soft Errors" (Soft-Fehler melden), "Report Status Messages" (Status-Nachrichten melden), "Quick Mode" (Schnellmodus), "Test Warning Level" (Testwarnstufe) und "Percent Of Test Coverage" (Testabdeckung in Prozent).
Assoziationen
Eine Instanz von IANetDiagSettingForTest assoziiert einen IANet_DiagTest mit einer IANet_DiagSetting-Instanz.
Nicht unterstützte Eigenschaften
Die folgenden Eigenschaften werden von NCS nicht unterstützt:
Methoden
Keine
Klassenhierarchie
Für CimV2. Unbenutzte Eigenschaften und Methoden werden nicht aufgeführt.
Zweck
Instanzen von IANet_DiagResult zeigen die Ergebnisdaten für einen bestimmten Testlauf auf einem bestimmten Adapter an. Instanzen dieser Klasse entsprechen auf identische Weise den Instanzen von IANet_DiagTest und IANet_DiagSetting.
Instanzen
Instanzen von IANet_DiagResult entsprechen den Ergebnissen für einen bestimmten Testlauf auf einem spezifischen Adapter. Für diesen Schlüssel wird dasselbe Format verwendet wie für IANet_DiagTest und IANet_DiagSetting. Die Instanz kann beliebige Testergebnisse speichern, und Daten, die nicht den definierten Eigenschaften entsprechen, können in der TestResults-Array-Eigenschaft untergebracht werden. Jedes Mal, wenn ein neuer Test für einen Adapter ausgeführt wird, überschreibt die neue Instanz die vorhandene Instanz der Testergebnisse für den Adapter und die Testkombination.
Erstellen von Instanzen
Sie können keine Instanzen dieser Klasse erstellen.
Löschen von Instanzen
Sie können keine Instanzen dieser Klasse löschen.
Ändern von Eigenschaften
Sie können keine Instanzen dieser Klasse ändern.
Assoziationen
Eine Instanz von IANet_DiagResultForTest assoziiert einen IANet_DiagTest mit einer IANet_DiagnosticResult-Instanz.
Nicht unterstützte Eigenschaften
Die folgenden Eigenschaften werden von NCS nicht unterstützt:
Methoden
Keine
Klassenhierarchie
Für CimV2. Unbenutzte Eigenschaften und Methoden werden nicht aufgeführt.
Die folgenden Einträge werden während der Installation unter HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag in die Registrierung aufgenommen. Diese weiter unten definierten Schlüssel und Werte steuern, wie die Diagnosetests ausgeführt werden.
Die folgende Tabelle zeigt die im Schlüssel angegebenen Werte, ihren Typ und eine kurze Erklärung bezüglich ihrer Verwendung:
| Wert | Typ | Standard | Verwendung |
| Check Time | REG_DWORD | 2 Sekunden | Zeitdauer zwischen den Überprüfungen auf Abschluss des Sender- oder Responder-Tests. |
| Enable | REG_DWORD | 0 | Aktiviert (1) oder deaktiviert (0) die Verwendung einer Ergebnis-Protokolldatei. |
| FileAppend | REG_DWORD | 1 | Ermöglicht das Anhängen (1) der Protokollergebnisdatei an die vorhandene Protokollergebnisdatei. Bei der Einstellung 0 wird die vorhandene Datei gelöscht. |
| LogFileName | REG_SZ | NcsDiag.log | Der Name der Protokollergebnisdatei. |
| MaxFileSize | REG_DWORD | 0x10000 | Die maximale Größe der Protokollergebnisdatei. |
| MaxPktsRcvd | REG_DWORD | 200 | Im Schnellmodus (Quick Mode in IANet_DiagSetting) wird das Senden/Empfangen eines Tests beendet, wenn die Anzahl der empfangenen Pakete den hier angegebenen Wert überschreitet. |
| TimeoutSndRsp | REG_DWORD | 100 | Der Test wird beendet, wenn die Testdauer (in Sekunden) diesen Wert überschreitet. |
Das Ergebnisprotokoll enthält hauptsächlich Informationen, die auch aus IANet_DiagResult-Objekten ermittelt werden könnten. Der Unterschied besteht darin, dass die Informationen, die von einem CIM-Browser ermittelt werden, nur die unmittelbar letzten Ergebnisse bestimmter Tests für einen bestimmten Adapter enthalten. Nachfolgende Tests überschreiben frühere Testergebnisse. Das Ergebnisprotokoll bietet eine bequeme Lösung zum Einrichten und Anzeigen mehrfacher Durchläufe eines solchen Tests.
So wird das Ergebnisprotokoll aktiviert:
| Assoziative Klasse | Referenz-Eigenschaft/Wert | Referenz-Eigenschaft/Wert |
| 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 |
Die implementierten Tests können auf einem einzelnen Gerät oder auf zwei Geräten ausgeführt werden. Eine detaillierte Beschreibung der Tests ist im Rahmen dieses Dokuments nicht möglich. Der CDM Provider ist als generelle Testplattform gedacht, die unabhängig von den genauen Details der Tests verwendet werden kann. Eine gewisse Abhängigkeit ist jedoch in den Code integriert. Diese Abhängigkeit wird in diesem Abschnitt erläutert.
Die folgenden Tests werden auf einem Einzeladapter ausgeführt und erfordern keine Interaktion mit einem anderen Adapter:
Alle Fehlermeldungen dieser Tests resultieren aus HRESULT-Fehlercodes, die von Aufrufen an niedrigere Stapelschichten zurückgegeben werden. Die Fehlercodes werden intern als Fehlercodes gespeichert und werden erst dann in Fehlermeldungen übersetzt, wenn der Bezug auf IANet_DiagResult-Objekte durch Auflistung aufgehoben wird oder wenn Objektaufrufe von einer Verwaltungsanwendung empfangen werden.
Die Sender- und Responder-Tests setzen eine gegenseitige Abhängigkeit voraus. Ein Adapter (der Sender) sendet dabei Pakete an einen anderen Adapter (den Responder), der wiederum Pakete an den Sender zurücksendet und dadurch die Schleife vervollständigt. Es handelt sich dabei um dieselben Tests, die auch über Intel ® PROSet ausgeführt werden können. Intel PROSet verwendet jedoch CDM nicht und lässt das gleichzeitige Ausführen von zwei Tests auf demselben Gerät nicht zu. Mit CDM sind gleichzeitige Tests unterschiedlicher Art auf demselben Gerät möglich.
Für Sender/Responder-Tests sind zwei Intel Adapter erforderlich, wobei einer als Sender und der andere als Responder fungiert. Es handelt sich dabei um den einzigen Test, bei dem das Ausführen eines Tests auf einem zweiten Thread basiert, der so lange weiterläuft, bis der Test aufgrund bestimmter Abschlusskriterien beendet oder durch den primären Thread angehalten wird. Die Abschlusskriterien bewirken das Abschalten, sobald eine bestimmte Testzeit überschritten wird oder eine bestimmte Anzahl Pakete empfangen wurde. Beide Werte werden aus der Registrierung übernommen. Der Test kann nur dann aufgrund der Anzahl der empfangenen Pakete beendet werden, wenn Quick Mode (Schnellmodus) aktiviert wurde. Quick Mode ist eine Eigenschaft der IANet_DiagSetting-Klasse und kann darum für jeden Adapter separat eingestellt werden. CDM-Responder antworten auf PROSet-Responder und umgekehrt.
Bei Sender/Responder-Tests werden zwei Arten von Fehlerwerten zurückgegeben. Erstens kann ein Fehlercode (HRESULT) von den unteren Schichten zurückgegeben werden. Während der Test ausgeführt wird und solange der Test nicht vorzeitig durch einen zurückgegebenen Fehlercode beendet wird, gibt der Test-Thread zweitens vorläufige und endgültige Teststatistiken der folgenden Art zurück:
Lesen Sie bitte alle Einschränkungen und Haftungsausschlüsse.