目次に戻る

診断:Intel(R) PRO ネットワーク アダプタ WMI および CDM プロバイダ ユーザ ガイド

診断クラス
レジストリのエントリ
ログ記録
関連クラス
テスト


診断クラス

IANet_DiagTest

用途
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 用。未使用のプロパティとメソッドはあげてありません。

WbemTest での RunTest やその他のメソッドの実行

MOF ファイルの RunTest メソッドは次のとおりです。

uint32
RunTest([IN] CIM_ManagedSystemElement ref SystemElement,
[IN] CIM_DiagnosticSetting ref Setting,
[OUT] CIM_DiagnosticResult ref Result);

最初の 2 つのパラメータは In パラメータです。参照されている両方のオブジェクトのオブジェクト パスを取得することが必要です。また、RunTest オブジェクトをエクスポートする IANet_DiagTest オブジェクトのオブジェクト パスも取得してください。

  1. メインの WBEM テスト ダイアログ ボックスで [Connect (接続)] をクリックします。
  2. 適切な "サーバ\ネームスペース" を入力します。サポートされているネームスペースは、IntelNCS と CimV2 です。
  3. WBEM テストの [Enum Instances(インスタンスの列挙)] ボタンをクリックし、「IANet_DiagTest」と入力します。
  4. IANet_DiagTest のインスタンスをダブルクリックします。名前には「X@[AdapterGUID}」の形式を使用します。X にはテスト名、AdapterGUID にはアダプタ名 (IANet_EthernetAdapter の Name キーと同じ) を入れます。
  5. 次に、取得されるオブジェクト パスの例をあげます。
    \\MYCOMPUTER\root\Cimv2:IANet_DiagTest.Name="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  6. オブジェクト パスを保存します。
  7. WBEM テストの [Enum Instances (インスタンスの列挙)] ボタンをクリックし、「IANet_EthernetAdapter」と入力します。
  8. テストするアダプタをダブルクリックします。
  9. 次に、取得されるオブジェクト パスの例をあげます。
    \\MYCOMPUTER\root\cimv2:IANet_EthernetAdapter.DeviceID="{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  10. オブジェクト パスを保存します。
  11. WBEM テストの [Enum Instances (インスタンスの列挙)] ボタンをクリックし、「IANet_DiagSetting」と入力します。
  12. アダプタ/テストの組み合わせを示す設定をダブルクリックします。
  13. 次に、取得されるオブジェクト パスの例をあげます。
    \\MYCOMPUTER\root\cimv2:IANet_DiagSetting.SettingID="1@{4A0CDABE-F6C3-45D0-B60D-F6E7BAFA2C2C}"
  14. オブジェクト パスを保存します。
  15. メインの WBEM テスト ダイアログ ボックスで [Execute Method (メソッドの実行)] をクリックします。
  16. ダイアログ ボックスに IANet_DiagTest オブジェクトのパスを貼り付けます。[OK] をクリックします。
  17. メソッドの下にあるドロップダウン ボックスでテストを選択します。
  18. [Edit In Parameters (In パラメータの編集)] ボタンをクリックします。
  19. RunTest では、Setting と SystemElement が In パラメータです。保存しておいた Setting と Adapter のオブジェクト パスを貼り付けて、閉じます。
  20. Execute (実行)] ボタンをクリックします。
  21. In パラメータと同様の方法で、IANet_DiagResult クラスを列挙します。
  22. 必要に応じて、選択された結果オブジェクトを検討します。

IANet_DiagSetting

用途
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_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 ブラウザで入手する情報では、特定のアダプタにおける特定のテストの最後の結果のみが表示される点です。テストを繰り返し行うと、以前のテスト結果は新しいテスト結果で上書きされます。結果のログは、このようなテストを繰り返して実行する場合の設定や表示に便利です。

結果ログの使用

結果のログを有効にするには:

  1. レジストリ キー「HKLM\Software\Intel\NETWORK_SERVICES\NCS\NCSDiag」で、Enable を 1 に設定します。
  2. LogFileName の値を希望するログ ファイルの名前に変更するか、デフォルトの NcsDiag.log をそのまま使用します。
  3. ログ ファイルは、InstalledDir の値が示すディレクトリに保存されます。

先頭に戻る


関連クラス

関連クラス 参照プロパティ/値 参照プロパティ/値
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 オブジェクトの参照が列挙によって解除されるまで、または管理アプリケーションからオブジェクトへの呼び出しが受信されるまで、エラー メッセージに変換されることはありません。

2 つのアダプタを必要とするテスト

送信機と応答機のテストは、相互に依存するテストで、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) が返されることがあります。次に、テストが実行中で、エラー コードが返されて早期に停止されない限り、テスト スレッドから次のような中間テスト結果や最終テスト結果が返されます。


制限と免責条項をすべてお読みください。


目次に戻る 先頭に戻る