Show/Hide Toolbars

Irinos Measurement System

Navigation: MscDll Reference Guide > API (programming interface) > Transfer channels for dynamic measurement values

MSC_SetupExtendedDynamicChannel

Scroll Prev Top Next More

This function initializes a data transfer channel for dynamic measurement values.

 

Definition


MSC_STATUS

MSC_SetupExtendedDynamicChannel(

    MSC_HANDLE Handle,

    unsigned char OpCode,

    unsigned char NumberOfSubChannels,

    unsigned long SndBufferSize,

    void* SndBuffer

);

 

Parameter


Handle

Device-Handle, which has been returned by a previous call of the function MSC_OpenDevice.

Opcode

The opcode of the dynamic measurement (opcRDM1 or opcRDM2).

NumberOfSubChannels

Number of measurement channels, which are transferred in a data frame (= number of measurement channels used for the dynamic measurement).

SndBufferSize

The size of the send buffer must be 1.

SndBuffer

Pointer to the send buffer. Minimum length is 1 byte. Its content is not relevant. It is only required to keep to the data structure.
 

Return value


If successful, MSC_STATUS_SUCCESS will be returned. In case of an error, an error code will be returned.

 

Comments


An extended dynamic measurement channel stores the data in several FIFO like buffers. The buffers are provided by the application with the function MSC_AttachSubChannelBuffer.

The measurement is running if a buffer is attached to all of the subchannels and these buffers are not full.

All measurement values have the data type 32 bit signed long. This also applies to measurement channels, which have a 16 or 8 bit value range.

 

See also


MSC_OpenDevice

MSC_AttachSubChannelBuffer

MSC_GetPosition