TPM_EXECUTE (Compact 2013)
3/26/2014
This message is sent to the TestProc function each time that Tux asks the function to execute its test code.
Parameters
- uMsg
TPM_EXECUTE message.
- tpParam
Pointer to a TPS_EXECUTE structure.
Return Values
Returns TPR_SKIP, TPR_PASS, TPR_FAIL, or TPR_ABORT.
Remarks
The TestProc function is called with the TPM_EXECUTE message and a TPS_EXECUTE structure for each thread that is executing the test case. The threads are numbered from 1 to n, where n is the number of threads created. The TPS_EXECUTE structure will inform the test case of the current thread's number, the maximum thread number, and the thread's random seed.
Each thread contains a different random seed, which is derived from the random seed for the test case. Thread number 1 has a seed equal to that of the test case's seed. Threads 2 through n have seeds generated from the test case's main seed. This allows all test cases that use random numbers - even multi-threaded test cases - to be reproduced at a later time using the same random seed. If a multi-threaded test case is run more than once with the same seed, each thread is given the same seed as in previous runs.
Requirements
Header |
tux.h |