win_buf_to_array()

Copies data from a Windows memory buffer into an array.

Prototype

win_buf_to_array(memhandle, data_array, first_point, count)

Parameters

memhandle (int)

This must be a memory handle that was returned by win_buf_alloc() when the buffer was allocated. The buffer should contain the data that you want to copy.

data_array (POINTER(c_ushort))

The C array that the data is copied to.

first_point (int)

Index of the first point in the memory buffer that data is copied from.

count (int)

Number of data points to copy.

Notes

• This function copies data from a Windows global memory buffer to an array. This would typically be used to retrieve data from the buffer after executing an input scan function.
• Using the first_point and count parameters it is possible to copy only a portion of the buffer to the array. This can be useful if you want foreground code to manipulate previously collected data while a BACKGROUND scan continues to collect new data.
• Although this function is available to Python programs, it is not necessary, since it is possible to manipulate the memory buffer directly by casting the memhandle returned from win_buf_alloc() to the appropriate type. This method avoids having to copy the data from the memory buffer to an array.
• Refer to the following example