WinBufToArray64() method

Copies 64-bit data from a Windows global memory buffer into a one-dimensional or two-dimensional array. This method is typically used to retrieve data from the buffer after executing an input scan method.

Member of the MccService class.

Function Prototype

VB .NET

Copies data into a two-dimensional array of long values:

Public Shared Function WinBufToArray64(ByVal memHandle As IntPtr, ByVal dataArray(,) As Long(), ByVal firstPoint As Integer, ByVal numPoints As Integer, ByVal numChannels As Integer) As MccDaq.ErrorInfo

Copies data into an array of integer values:

Public Shared Function WinBufToArray64(ByVal memHandle As IntPtr, ByVal dataArray As Integer(), ByVal firstPoint As Integer, ByVal numPoints As Integer) As MccDaq.ErrorInfo

Copies data into an array of System.UInt64 values:

Public Shared Function WinBufToArray64(ByVal memHandle As IntPtr, ByVal dataArray As System.UInt64(), ByVal firstPoint As Integer, ByVal numPoints As Integer) As MccDaq.ErrorInfo

C# .NET

Copies data into a two-dimensional array of long values:

public int MccDaq.ErrorInfo WinBufToArray64(IntPtr MemHandle, long[] dataArray, int firstPoint, int numPoints)

Copies data into an array of integer values:

public int MccDaq.ErrorInfo WinBufToArray64(IntPtr memHandle, int[] dataArray, int firstPoint, int numPoints)

Copies data into an array of System.UInt64 values:

public int MccDaq.ErrorInfo WinBufToArray64(int memHandle, uint[] dataArray, int firstPoint, int numPoints)

Parameters

memHandle

The memory handle that was returned by WinBufAlloc64() when the buffer was allocated. The buffer should contain the data that you want to copy.

dataArray

The array where the data is copied.

firstPoint

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

numPoints

The number of data points to copy.

numChannels

The number of channels to copy into dataArray.

Returns

• An ErrorInfo object that indicates the status of the operation.

Notes

• You can copy only a portion of the buffer to the array using the firstPoint and numPoints argument. This is useful if you want foreground code to manipulate previously collected data while a Background scan continues to collect new data.
• Although this method is available to Windows C programs, it is not necessary, since you can manipulate the memory buffer directly by casting the MemHandle returned from WinBufAlloc64() to the appropriate type. This method avoids having to copy the data from the memory buffer to an array.

• Refer to the following example: