返回目录页面

诊断程序: 英特尔(R) PRO 网络适配器和 WMI 和 CDM Provider 用户指南

诊断类
注册表条目
记录日志
关联类
测试


诊断类

IANet_DiagTest

目的
IANet_DiagTest 是来自 CIM_DiagnosticTest 的子类。此类提供一个通用手段来运行和控制对 Intel(R) PROSet 支持的以太网适配器进行的诊断测试。CIM_DiagnosticTest 是一个超类,旨在向在启用了 CIM 的系统上对任何计算机硬件进行测试提供通用支持。该类的属性在本质上是描述性的,而且测试机制由显露的方法提供。

实例
主键是“Name”,在此 provider 中,它是在引用的适配器 GUID 上的测试数字索引的结合(例如:1@{12345678-9ABC-DEF0-1234-123456789012})。此主键的值在某种意义上是一项多余的信息,因为所有引用一个适配器和测试的信息都被作为对象参数被传递到 RunTest 和其他方法。但是,实例必须与传递至方法的参数一致,否则 provider 将拒绝该项命令。标题属性提供此实例将要运行的测试的名称。其他属性提供其他描述和运行时信息。

创建实例
不能创建 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);

前两个参数为 In 参数。必须获取被引用的两个对象的对象路径。还必须获取 IANet_DiagTest 对象的对象路径,它将导出 RunTest 对象。

  1. 从主 WBEM 测试对话框,单击 Connect(连接)。
  2. 输入合适的服务器\名称空间。Namespaces 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. 枚举 IANet_DiagResult 类,其方式与 In 参数相同。
  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_DiagTest 和 ANet_DiagSetting 相关联。

不受支持的属性
以下属性不受 NCS 支持:

方法
无

类层次结构

对 CimV2。不列出未使用的属性和方法。

IANet_DiagResult

目的
IANet_DiagResult 显示在特定适配器上运行的特定测试的结果数据。此类的实例跟 IANet_DiagTest 和 IANet_DiagSetting 实例一一对应。

实例
IANet_DiagResult 的实例和在特定适配器上运行的特定测试的结果相对应。主键格式跟 IANet_DiagTest 和 IANet_DiagSetting 相同。此实例能将任何随意测试结果储存为任何数据(不符合定义的属性),可被置入 TestResults 数组属性。任何时候在一个适配器上运行一个新测试,其新实例将覆盖与此适配器和测试组合相应的测试结果的现有实例。

创建实例
不能创建此类的实例。

删除实例
不能删除此类的实例。

修改属性
不能修改此类的实例。

关联
IANet_DiagResultForTest 实例使 IANet_DiagTest 和 IANet_DiagnosticResult 实例相关联。

不受支持的属性
以下属性不受 NCS 支持:

方法
无

类层次结构

对 CimV2。不列出未使用的属性和方法。

返回页首


注册表条目

以下条目在安装时被输入 HKLM\Software\Intel\NETWORK_SERVICES\NCS\NcsDiag 下的注册表。这些表项和值控制诊断测试的执行,其定义如下。

以下表格包含主键的值、其类型,以及对其用法的简单描述:

 
值 类型 默认值 用法
检查时间 REG_DWORD 2 秒 检查对发送方或响应方测试的完成情况的间隔时间长短。
启用 REG_DWORD 0 “启用” (1) 或“禁用” (0) 结果日志文件。
FileAppend REG_DWORD 1 将结果文件“附加”(1) 到现有日志结果文件。如果为 0,则删除现有文件。
LogFileName REG_SZ NcsDiag.log 日志结果文件的名称。
MaxFileSize REG_DWORD 0x10000 日志结果文件的最大大小。
MaxPktsRcvd REG_DWORD 200 在“快速模式”中(从 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

返回页首


测试

被实施的测试可在一台或两台计算机上运行。有关测试的详细描述不属本文档的范围,因为 CDM provider 的主旨是作为一个不必依赖于具体测试细节的通用的测试手段。但是,代码中仍然还有一些内在的依赖性,本节将予以解释。

单个适配器测试

以下测试在单个适配器上运行,不须和其他任何适配器进行交互。

这些测试的错误消息来自向较低堆栈层次发出的调用返回的 HRESULT 错误代码。错误代码作为错误代码存储在内部,以下两种情况将导致它们被转换为错误消息:IANet_DiagResult 对象因枚举而被反引用;管理应用程序接收到对象调用指令。

要求两个适配器的测试

发送方和响应方测试相互依赖,其中一个适配器(发送方)将数据包发送到另一个适配器(响应方),后者将数据包送回给发送方,至此完成一个循环。这些是相同的测试,都可以从英特尔(R) PROSet 运行。但是, 英特尔(R) PROSet 不使用 CDM,也不允许在同一个机器上同时运行两个测试。CDM 允许同时在同一个机器上运行不同的测试。

发送方响应方测试

发送方/响应方要求两个英特尔适配器,一个为发送方,一个为响应方。这是唯一基于第二个线程运行的测试;该线程保持运行直至测试按照完成标准得以完成或者被主线程中止。完成标准是基于测试时间长度所定的超时,或是基于接收到的数据包数目。这两项值均来自注册表。如果启用了“Quick”模式,则测试仅能基于接收到的数据包数目结束。“Quick”模式是 IANet_DiagSetting 类的属性,因此能对适配器进行个别设置。CDM 响应方对 PROSet 响应方作出响应,反之亦然。

发送方/响应方测试返回两类错误值。首先,可能从较低层次返回一个 Error Code (错误代码)(HRESULT) 。其次,在测试运行时(除非测试被返回的错误代码先期中断),测试线程将返回中级测试统计数据,然后返回最终测试统计数据,包含以下各项:


请阅读所有限制和免责声明。


返回目录页面 返回页首