KEYENCE LJ-V7000 Series User Manual
Page 40

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