Share via


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.

See Also

Other Resources

OAL - IOCTL Tests