DoStressIteration

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/27/2008

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.

Syntax

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 Value

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

See Also

Other Resources

Custom Stress Module Functions