Use the Configure entry point to provide a mechanism for end users to configure the handler/prober driver and to persist the settings for multiple lots.

The General tab of the default Configure Station Settings dialog box contains a Configure Handler/Prober button that calls the Configure entry point of the handler/prober driver sequence file that the Standard.HandlerDriverSequenceFilePath property of the station settings specifies.

The Configure entry point accepts the following parameters:

Parameter Type Description
HandlerDriverData Input or Output Container that stores handler-specific or prober-specific settings or run-time data. In a handler/prober driver sequence file, you can modify the default structure of this parameter, such as by changing the data type from the default Container to a custom container data type. However, the Configure entry point must create, and optionally assign, each field of this parameter using the TestStand API, such as the PropertyObject.NewSubProperty method or a PropertyObject Set value method, such as SetValNumber.

Do not enable the Check Type option for this parameter. Right-click the parameter and remove the checkmark from Check Type in the context menu to disable the Check Type option.
Canceled Output Boolean value that notifies TSM whether the handler/prober settings have been modified and must be saved to disk. A value of True indicates that the handler/prober settings have not changed. A value of False indicates that the handler/prober settings have been modified and must be saved to disk.
SemiconductorModuleManager Input or Output Object reference to an instance of a Semiconductor Module Manager. Use this object reference with the TSM Application API to get information about the currently configured lot.

Persisting Handler/Prober Configuration Settings

TSM automatically persists the configuration settings that the Configure entry point returns in the HandlerDriverData parameter to disk when the Canceled parameter is False. TSM stores configurations settings for all handler/prober drivers in the <TestStand Config>\NI_SemiconductorModule\HandlerProberDrivers.cfg file.