Pointer/Handle Parameters

Use a Pointer/Handle parameter to pass the address of a pointer parameter from a C/C++ DLL code module to TestStand and from TestStand to the code module.

Usually, you must allocate a pointer inside a function the code module exports and return the pointer as a void* return value. TestStand stores the pointer as an object reference, and you can later pass the reference to a different function in the code module. You must release the pointer inside the code module when you no longer need it.

Any pointer, array, or string parameter is compatible with the Pointer/Handle parameter category.

The Variables pane displays Pointer:Address , where Address is a hexadecimal number that corresponds to the address of the pointer, when TestStand stores a pointer as an object reference.

Pass by Value or Reference

When you select the Pointer/Handle category for a parameter, the C/C++ DLL Adapter displays the Pass control, which specifies whether TestStand passes the value of the argument you specify in the Value Expression control or passes a pointer to the argument. If you select By Pointer ( * ) or By Reference ( & ), the adapter passes a pointer to the argument value.

See Also

Mapping Parameters

Pointers and Handles in 32-bit TestStand and 64-bit TestStand

Representing Pointers in Sequences in 32-bit TestStand and 64-bit TestStand

Representing Pointer-Sized Numbers in Sequences in 32-bit TestStand and 64-bit TestStand