Show/Hide Toolbars

Irinos Measurement System

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

MSC_GetPosition

Scroll Prev Top Next More

This function returns the position of a dynamic measurement. This allows determining the number of measurement values, which have already been sampled and transferred to the MscDll.

 

Definition


MSC_STATUS
MSC_GetPosition(
    MSC_HANDLE Handle,
    unsigned char OpCode,
    unsigned long* Position
);

 

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).

Position

Returns the position of the dynamic measurement in bytes (see also comment below).

 

Return value


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

 

Comments


Measurement values are always stored as 32 bit values. In order to get the number of measurement values, the variable "Position" must be divided by 4.

Example: If a buffer is filled with 400 bytes, it contains 100 measuring values.

 

See also


MSC_OpenDevice

MSC_SetupExtendedDynamicChannel

MSC_AttachSubChannelBuffer