Sequence File Translator Functions

A TestStand sequence file translator DLL must export and implement the following C callback functions. When a translator DLL does not export all the callback functions, TestStand does not load the DLL.

Error Handling

Each callback function contains three parameters for error handling—an error code, an error string, and the maximum length for the error string. When an error occurs within a callback function, set the error code to a non-zero value. When the value you assign is a TestStand error code, TestStand uses the standard error code description. The callback function can copy additional error details to the standard error message string. However, the callback must not exceed the specified number of bytes for the maximum length for the error message. TestStand uses the error message string the callback function specifies.

Note Avoid returning errors from C callback functions to TestStand, which might not properly handle the errors. Refer to the example translator projects in <TestStand Public> \Examples\Fundamentals\Sequence File Translators - Examples for examples of how to return errors from within callback functions.