Share via


Radio Manager - Verify SetRadioState

This automated test validates that the Radio Manager properly implements the SetRadioState() and **GetRadioState()**functions. This test turns the radio on and off many times and fails if the functions take longer than the time allotted by the Windows certification requirements.

Important  

You must run this test for each Radio Manager that is installed on the system and package the results together. For example, if a machine has a GPS radio manager and an NFC radio manager, you must run this test twice; once to test the NFC radio manager and second time to test the GPS radio manager.

 

Test details

Associated requirements

System.Client.RadioManagement.RadioMaintainsState System.Client.RadioManagement.RadioManagerCOMObject

See the system hardware requirements.

Platforms

Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86

Expected run time

~2 minutes

Categories

Basic Certification Functional

Type

Automated

 

Running the test

Before you run the test, complete the test setup as described in the test requirements: System Client Testing Prerequisites.

In addition, input the following parameters before you run the test:

  • RadioMgrSignature: The Radio Manager Signature GUID as registered with the Radio Management APIs. This parameter MUST be in GUID format – {12345679-1234-1234-1234-1234567890AB} (curly braces included).

  • RadioInstanceID: The Radio Instance ID of the radio which is under test. This could be in a GUID format or device path string, depending on the implementation of the Radio Manager.

Important  

If the RadioMgrSignature and RadioInstanceID parameters are not given values (empty strings), the tests run in a 'Not Implemented' mode. This means the system doesn't have a third-party Radio Manager installed. In this case, the test passes if a third-party Radio Manager isn't detected. The test fails if a third-party Radio Manager is detected and the parameters are empty.

 

Troubleshooting

For troubleshooting information, see Troubleshooting System Client Testing.

The tests provide logs which describe what action caused a failure, along with any related HRESULT values to assist in debugging issues.

More information

This test includes the following test cases:

  • RadioMgrLogoTests::VerifyTurnRadioOn

  • RadioMgrLogoTests::VerifyTurnRadioOff

  • RadioMgrLogoTests::VerifyContinuousRadioStateChange

Command syntax

Command option Description

TE.exe RadioLogoTest.dll /name:<test_name> /p:RadioMgrSignature=<RadioMgrSignature> /p:RadioInstanceID=<RadioInstanceID>

Runs the test. For example:

TE.exe RadioLogoTest.dll /name:RadioMgrLogoTests::VerifyOnOffNotifications /p:RadioMgrSignature={12345679-1234-1234-1234-1234567890AB} /p:RadioInstanceID={12345679-1234-1234-1234-1234567890AB}

 

File list

File Location

RadioLogoTest.dll

<testbinroot>\nttest\nettest\netui\RadioManagement\Logo

TAEF files

<testbinroot>\..\..\TaefBinaries\<architecture>

 

 

 

Send comments about this topic to Microsoft