DoStressIteration

  • 项目

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 Modular Stress Test

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.