診断クラス
レジストリのエントリ
ログ記録
関連クラス
テスト
用途
IANet_DiagTest は、CIM_DiagnosticTest のサブクラスです。このクラスでは、Intel(R) PROSet でサポートされているイーサネット アダプタの診断テストを実行およびコントロールするための一般的な手段が提供されます。スーパークラス CIM_DiagnosticTest は CIM 対応システムのすべてのコンピュータ ハードウェアのテストを一般的にサポートするように設計されています。クラスのプロパティは基本的に記述的で、テストのメカニズムは明示されたメソッドによって提供されます。
インスタンス
キーは Name で、このプロバイダでは参照されているアダプタの GUID でのテストの数字によるインデックスをつなげたものになります (例:1@{12345678-9ABC-DEF0-1234-123456789012})。このキー値は、アダプタとテストを参照するすべての情報が RunTest とその他のメソッドにオブジェクト パラメータとして渡されるため、ある意味で冗長な情報です。それでも、インスタンスはメソッドへのパラメータと一致することが必要で、一致しない場合はプロバイダによってコマンドが拒否されます。キャプション プロパティでは、このインスタンスが実行するテストの名前が提供されます。その他のプロパティでは、その他の記述的な情報と、実行時の情報が提供されます。
インスタンスの作成
IANet_DiagTest のインスタンスを作成することはできません。
インスタンスの削除
IANet_DiagTest のインスタンスを削除することはできません。
プロパティの変更
このクラスには、ユーザが変更できるプロパティはありません。
関連
サポートされていないプロパティ
Install Date、OtherCharacteristicDescription
メソッド
このクラスでは、次のメソッドがサポートされます。
クラス階層
CimV2 用。未使用のプロパティとメソッドはあげてありません。
MOF ファイルの RunTest メソッドは次のとおりです。
uint32
RunTest([IN] CIM_ManagedSystemElement ref SystemElement,
[IN] CIM_DiagnosticSetting ref Setting,
[OUT] CIM_DiagnosticResult ref Result);
最初の 2 つのパラメータは In パラメータです。参照されている両方のオブジェクトのオブジェクト パスを取得することが必要です。また、RunTest オブジェクトをエクスポートする IANet_DiagTest オブジェクトのオブジェクト パスも取得してください。
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}"用途
IANet_DiagSetting のインスタンスは、特定のランタイム診断テストの指令を提供します。使用される指令は全テストに共通で、スーパークラス CIM_DiagnosticSetting にバインドされます。これらには ReportSoftErrors や HaltOnError などのプロパティが含まれます。サブクラス IANet_DiagSetting には追加のプロパティはありません。
インスタンスの作成
このクラスのインスタンスを作成することはできません。
インスタンスの削除
このクラスのインスタンスを削除することはできません。
プロパティの変更
UpdateInstanceAsync が実装され、テスト パラメータを "Halt On Error (エラー時に中断)"、"Report Soft Errors (ソフト エラーのレポート)"、"Report Status Messages (レポート ステータスのメッセージ)"、"Quick Mode (クイック モード)"、"Test Warning Level (警告レベルのテスト)" および "Percent Of Test Coverage (テストのカバー範囲の割合)" に設定するのに使用できます。
関連
IANetDiagSettingForTest のインスタンスは、IANet_DiagSetting で IANet_DiagTest と関連をもちます。
サポートされていないプロパティ
次のプロパティは NCS ではサポートされていません。
メソッド
なし
クラス階層
CimV2 用。未使用のプロパティとメソッドはあげてありません。
用途
IANet_DiagResult のインスタンスは、特定のアダプタの特定のテストの実行に関する結果のデータを表示します。このクラスのインスタンスは、IANet_DiagTest と IANet_DiagSetting のインスタンスに完全に対応します。
インスタンス
IANet_DiagResult のインスタンスは、特定のアダプタの特定のテストの実行に関する結果に対応します。キーの形式は、IANet_DiagTest や IANet_DiagSetting と同じです。このインスタンスは、定義されたプロパティにあてはまらない任意のテスト結果を任意のデータとして保管し、TestResults Array に配置することができます。アダプタで新しいテストを実行するたびに、新規のインスタンスが、アダプタとテストの組み合わせの一致するテスト結果の既存のインスタンスを上書きします。
インスタンスの作成
このクラスのインスタンスを作成することはできません。
インスタンスの削除
このクラスのインスタンスを削除することはできません。
インスタンスの変更
このクラスのインスタンスを変更することはできません。
関連
IANet_DiagResultForTest のインスタンスは、IANet_DiagnosticResult で IANet_DiagTest と関連をもちます。
サポートされていないプロパティ
次のプロパティは NCS ではサポートされていません。
メソッド
なし
クラス階層
CimV2 用。未使用のプロパティとメソッドはあげてありません。
インストール時に、HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag に以下のレジストリ エントリが入力されます。これらのキーと値は、診断テストの実行をコントロールし、次のように定義されます。
次の表に、キーの値、タイプ、および使用方法に関する簡単な説明をリストします。
| 値 | タイプ | デフォルト | 使用方法 |
| Check Time | REG_DWORD | 2秒 | 送信機や応答機のテストの完了をチェックする間隔。 |
| Enable | REG_DWORD | 0 | 結果のログ ファイルを使用する (1) または使用しない (0)。 |
| FileAppend | REG_DWORD | 1 | 結果のログ ファイルを既存のログ ファイルに追加する (1)。0 の場合は、既存のファイルが削除されます。 |
| LogFileName | REG_SZ | NcsDiag.log | 結果のログ ファイルの名前。 |
| MaxFileSize | REG_DWORD | 0x10000 | 結果のログ ファイルの最大サイズ。 |
| MaxPktsRcvd | REG_DWORD | 200 | Quick Mode (IANet_DiagSetting から) の場合、受信パケットの数がこの値よりも大きい際に送受信テストを中止します。 |
| TimeoutSndRsp | REG_DWORD | 100 | テスト時間 (秒) がこの値を超えた場合、テストを終了します。 |
結果のログは、主に情報を表示します。これらの情報は IANet_DiagResult オブジェクトから取得することもできます。両者の違いは、CIM ブラウザで入手する情報では、特定のアダプタにおける特定のテストの最後の結果のみが表示される点です。テストを繰り返し行うと、以前のテスト結果は新しいテスト結果で上書きされます。結果のログは、このようなテストを繰り返して実行する場合の設定や表示に便利です。
結果のログを有効にするには:
| 関連クラス | 参照プロパティ/値 | 参照プロパティ/値 |
| 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 |
実装したテストは、単独のマシンか、2 台のマシンで実行できます。CDM Provider はテストの内容に依存しない、一般的なテスト手段として設計されているため、テストの詳細な説明は本文書では扱いません。ただし、コードの一部で依存性が生じる部分があるため、この項ではその部分について説明します。
次のテストは単独のアダプタで実行され、ほかのアダプタとの通信は必要としません。
これらのテストからのエラー メッセージはすべて、スタック層の下層への呼び出しから返された HRESULT エラー コードからのものです。エラー コードはエラー コードとして内部で保管され、IANet_DiagResult オブジェクトの参照が列挙によって解除されるまで、または管理アプリケーションからオブジェクトへの呼び出しが受信されるまで、エラー メッセージに変換されることはありません。
送信機と応答機のテストは、相互に依存するテストで、1 つのアダプタ (送信機) がパケットを別のアダプタ (応答機) に送信し、応答機から送信機にパケットが送り返されることで、ループが完了します。これらは、Intel(R) PROSet から実行できるのと同じテストです。ただし、Intel PROSet では CDM は使用されず、同じマシンに 2 つのテストを同時に実行することはできません。CDM では、同じマシンに複数のテストを同時に実行できます。
送信機/応答機では、2 つの Intel アダプタが必要で、1 つは送信機、もう 1 つは応答機になります。このテストは、2 つめのスレッドに基づいてテストが実行され、このスレッドがテストが完了条件を満たして完了するまで、または 1 つめのスレッドによって停止されるまで実行し続ける、唯一のテストです。完了条件とは、テスト時間か、受信パケット数に基づくタイムアウトです。これらの値は両方とも、レジストリから取得されます。Quick モードがオンの場合は、テストは受信パケット数に基づいてのみ終了できます。Quick モードとは、IANet_DiagSetting クラスのプロパティで、アダプタごとに設定できます。CDM 応答機は PROSet 応答機に応答し、CDM 応答機は PROSet 応答機に応答します。
送信機/応答機テストで返されるエラー値には、2 つのタイプがあります。まず、下層レイヤから Error Code (HRESULT) が返されることがあります。次に、テストが実行中で、エラー コードが返されて早期に停止されない限り、テスト スレッドから次のような中間テスト結果や最終テスト結果が返されます。
制限と免責条項をすべてお読みください。