beautypg.com

KEYENCE LJ-V7000 Series User Manual

Page 40

background image

40

LJ-V7000_COM_RM_E

Get batch profiles (operation mode "advanced (with OUT measurement)")

Format

LONG LJV7IF_GetBatchProfileAdvance(LONG lDeviceId,

LJV7IF_GET_BATCH_PROFILE_ADVANCE_REQ* pReq,

LJV7IF_GET_BATCH_PROFILE_ADVANCE_RSP* pRsp,

LJV7IF_PROFILE_INFO* pProfileInfo, DWORD* pdwBatchData, DWORD

dwDataSize, LJV7IF_MEASURE_DATA* pBatchMeasureData,

LJV7IF_MEASURE_DATA* pMeasureData);

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

dwBatchData(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 -

LJV7IF_MEASURE_DATA x 16 OUTs" as a single unit of profile data, and only

the number of profiles that could be acquired are returned.

The results of the measurement process for the relevant profile are stored in

LJV7IF_MEASURE_DATA.

dwDataSize(in)

pdwProfileData size in BYTEs.

pBatchMeasureData(out)

The measurement results for the batch data that is the target to get.

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

measuring.

pMeasureData(out)

The newest measurement results at the time the command was processed.

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

0x8081: Not "batch measurements on and profile compression (time axis) off"

0x80A0: No batch data (batch measurements not run even once)

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". For pdwBatchData/pBatchMeasureData, OUT

measurements where the measurement mode is set to "do not measure" are also

stored.

To read all of the profiles in one batch, read them with the procedure below.

1. Call this function by specifying LJV7IF_BATCH_POS_CURRENT for

byPosMode in pReq. Save the start position and the amount of profiles

that were read and the batch number that was read.

2. Configure pReq as listed below and call this function again.

byPosMode=LJV7IF_BATCH_POS_SPEC

dwGetBatchNo = batch number that was read

dwGetProfNo = starting profile number of the unread profiles in the batch

3. Update dwGetProfNo in step 2 and call this function until all of the profiles

in the batch can be read.

When calling this function, do not perform communication between the target

controller and LJ-Navigation 2.

Supported version

1.00