DoStressIteration (Windows CE 5.0)

Send Feedback

This function is the main function for a test. This function is called one time at the beginning of each test thread. An iteration of a test should start and finish in this function, but you can call other functions during the test.

UINT DoStressIteration(  HANDLE hThread,  DWORD dwThreadId,  LPVOID pv);

Parameters

• hThread
  [in] Pseudohandle to the current thread. A pseudohandle is a special constant that is interpreted as the handle to the current thread. The calling thread can use this handle to specify itself whenever a thread handle is required.
• dwThreadId
  [in] Identifier for the thread.
• pv
  [in] Pointer to an ITERATION_INFO structure.

Return Values

This function must return one of the following values:

• CESTRESS_PASS
• CESTRESS_FAIL
• CESTRESS_WARN1
• CESTRESS_WARN2
• CESTRESS_ABORT

Use the CESTRESS_ABORT return value carefully because the harness terminates a test that returns this value immediately. For more information about these return values, see CESTRESS Return Value.

Remarks

The harness requires that you implement and export this function in a custom test module.

This function should represent a single iteration of a stress test, with a single result. One discrete operation should be performed each time this function is called. The return value for this function should represent the result for a single iteration, or test case.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Developer defined.
Link Library: Developer implemented.

See Also

Custom Stress Module Functions | Custom Module Creation for the Windows CE Stress Tool

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.