CITL_WaitCollectDataRecvEvent
This function waits for data to be sampled in data sampling in each sequence scan.
■ Format
short CITL_WaitCollectDataRecvEvent (unsigned short usWaitRecord, unsigned long ulTimeout)
■ Argument
Argument
Name
usWaitRecord
Number of wait records
ulTimeout
Timeout value
■ Description
• This function waits until the number of records specified to the number of wait records (usWaitRecord) is sampled in the
temporary area for data sampling in each sequence scan.
• When data has already been sampled in the temporary area at the time of executing the CITL_WaitCollectDataRecvEvent
function, this function ends normally without waiting for data to be sampled. Acquire the target data in the temporary area
and execute the function again. When data sampling in each sequence scan is stopped, an error occurs.
• The specified timeout value is rounded to the tick unit. Specify a timeout value of one tick or more.
■ Return value
Return value
Description
0 (0000H)
Normal
Other than 0 (0000H)
Error
For details on the error, refer to the following chapter.
Page 108 ERROR CODE LIST
■ Relevant function
Page 32 CITL_GetCollectData
Page 47 CITL_SetCollectData
Page 52 CITL_StartCollectData
Page 54 CITL_StopCollectData
Description
Specify the number of records waiting to be sampled.
Specify the timeout value in ms units (0H to FFFFFFFFH).
(When FFFFFFFFH is specified, the function waits for an event infinitely.)
3.1 C Intelligent Function Module Dedicated Functions
IN/OUT
IN
IN
3 DETAILS OF FUNCTION
3
61