目的
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。不列出未使用的属性和方法。
来自 MOF 文件的 RunTest 方法如下:
uint32
RunTest([IN] CIM_ManagedSystemElement ref SystemElement,
[IN] CIM_DiagnosticSetting ref Setting,
[OUT] CIM_DiagnosticResult ref Result);
前两个参数为 In 参数。必须获取被引用的两个对象的对象路径。还必须获取 IANet_DiagTest 对象的对象路径,它将导出 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}"目的
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_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 浏览器获取的信息将仅显示在特定适配器上进行的特定测试的最后一个结果。后随的测试结果覆盖先前的测试结果。“结果”日志比较容易设置,而且可以查看某一项测试的多次运行结果。
要启用结果日志:
| 关联类 | 首选项属性/值 | 首选项属性/值 |
| 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) 。其次,在测试运行时(除非测试被返回的错误代码先期中断),测试线程将返回中级测试统计数据,然后返回最终测试统计数据,包含以下各项:
请阅读所有限制和免责声明。