6 acquiring measurement results, Acquiring measurement results – KEYENCE LJ-V7000 Series User Manual

Page 37

Advertising
background image

37

LJ-V7000_COM_RM_E

9.2.6 Acquiring measurement results

For communication devices, see "9.2.9.1 Communication devices".

Get measurement results

Get profiles (operation mode "high-speed (profile only)")

Format

LONG LJV7IF_GetMeasurementValue(LONG lDeviceId,

LJV7IF_MEASURE_DATA* pMeasureData);

Parameters

lDeviceId(in)

Specifies the communication device to communicate with.

pMeasureData(out)

This buffer stores the data for all 16 OUTs including the OUTs that are not

measuring.

The host requires the passing of a buffer LJV7IF_MEASURE_DATA[16] in

size.

Return value

0x8080: The operation mode is "high-speed (profile only)"

Explanation

This function gets the newest measurement results (measurement values and

judgment results). All measurements, including OUT measurements where the

measurement mode is set to "do not measure" are acquired.

Supported version

1.00

Format

LONG LJV7IF_GetProfile(LONG lDeviceId, LJV7IF_GET_PROFILE_REQ* pReq,

LJV7IF_GET_PROFILE_RSP* pRsp, LJV7IF_PROFILE_INFO* pProfileInfo,

DWORD* pdwProfileData, DWORD dwDataSize);

Parameters

lDeviceId(in)

Specifies the communication device to communicate with.

pReq(in)

Specifies the position, etc., of the profiles to get.

For each member, see "8 Constant, Structure Definitions".

pRsp(out)

Indicates the position, etc., of the profiles that were actually acquired.

For each member, see "8 Constant, Structure Definitions".

pProfileInfo(out)

The profile information for the acquired profiles.

For each member, see "8 Constant, Structure Definitions".

pdwProfileData (out)

The buffer to get the profile data.

The profile data is stored in this buffer with "LJV7IF_PROFILE_HEADER -

signed 32-bit profile data - LJV7IF_PROFILE_FOOTER" as a single unit of

profile data, and only the number of profiles that could be acquired are

returned.

dwDataSize(in)

pdwProfileData size in BYTEs

Return value

0x8080:

The operation mode is "advanced (with OUT measurement)"

0x8081:

"Batch measurements on and profile compression (time axis) off"

0x80A0:

No profile data

Explanation

This function gets profile data.

Profile data is stored in 0.01 μm units.

For the details on the data stored in the profile data (storage order and size), see

"9.2.9 Supplement".

There is a limit to the number of profiles that can be read at once. This limit

depends on the measurement settings. Refer to byGetProfCnt (the number of

profiles read this time) in pRsp, and confirm that the data you wish to acquire

has all been acquired. If it could not be acquired, specify the following in this

function to acquire the remaining data:

byPosMode in pReq = LJV7IF_PROFILE_POS_SPEC

dwGetProfNo in pReq = dwGetTopProfNo in pRsp + byGetProfCnt in pRsp

(Specify the profile data to be read as the next profile data after the profile data

that was read this time)

Supported version

1.00

Advertising