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 |
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> |