IOCTL_HAL_GET_POWER_DISPOSITION Test (Compact 2013)
3/26/2014
The IOCTL_HAL_GET_POWER_DISPOSITION Test verifies the correct implementation of IOCTL_HAL_GET_POWER_DISPOSITION.
Test Prerequisites
Your device must meet the following requirements before you run this test.
As with the other OAL IOCTL tests, the IOCTL_HAL_GET_POWER_DISPOSITION Test requires no additional hardware.
* The run-time image must implement IOCTL_HAL_GET_POWER_DISPOSITION.
The following table shows the software requirements for the test:
Requirements |
Description |
---|---|
Tux.exe |
Tux test harness, required for executing the test |
ktux.dll |
Required to run kernel-mode tux tests |
kato.dll |
Kato logging engine, required for logging test data |
oaltestioctls.dll |
Library containing OAL IOCTL Test files |
Subtests
The table below lists the subtests included in this test.
SubTest ID |
Description |
---|---|
5600 |
Test that IOCTL_HAL_GET_POWER_DISPOSITION returns a valid wake source. |
5601 |
Test that input buffers are ignored for IOCTL_HAL_GET_POWER_DISPOSITION. |
5602 |
Test IOCTL_HAL_GET_POWER_DISPOSITION buffers fail at appropriate times. |
Setting Up the Test
This test has no additional requirements, beyond the standard test environment setup.
Running the Test
The default command line for this test is:
tux.exe -o -n -d oalTestIoctls.dll -x 5600-5602
Verifying the Test
* When the test completes running, verify that "PASS" appears in the test log for all sub-tests.
Troubleshooting the Test
* Verify the implementation of the IOCTL_HAL_GET_POWER_DISPOSITION.
* Determine the point of failure and record the exact error message. If the source code is available, examine the point of failure in code to see if any additional information can be gathered about the failure domain.