Omron DeviceNet 3G8F7-DRM21-E, Руководство по эксплуатации

Страница: 97 / 149

80
Explicit Message API Functions
Section 4-6
Description Use this function to change the message monitoring timer value.
The default value (2 s, or 2,000 ms) will be used when 0 is set as the message
monitoring timer value.
Reading the Message Monitoring Timer: SCAN_GetMessageTimerValue()
Application Range Open status
Function Reads the message monitoring timer value of the explicit client connection
with the specified node address.
Call Format BOOL SCAN_GetMessageTimerValue(DWORD Handle , WORD MacId ,
WORD * Epr )
Arguments
Return Value TRUE is returned when the message monitoring timer value was successfully
read. FALSE is returned if an error occurred. Detailed error information can be
read with the GetLastError() function.
Description Use this function to check the current message monitoring timer value.
The default message monitoring timer value, 0 (2 s), will be read when the
value is not set using SCAN_SetMessageTimerValue().
Storing the Message Monitoring Timer List: SCAN_StoreMessageTimerValueList()
Application Range Open status
Function Saves the explicit client connection’s message monitoring timer list to non-vol-
atile memory.
Call Format BOOL SCAN_StoreMessageTimerValueList(DWORD Handle )
Arguments
Return Value TRUE is returned when the message monitoring timer list was successfully
saved to non-volatile memory. FALSE is returned if an error occurred.
Detailed error information can be read with the GetLastError() function.
Description Message monitoring timer values for all node addresses are saved.
The message monitoring timer list saved to non-volatile memory is enabled
when SCAN_LoadMessageTimerValueList() is used.
Loading the Message Monitoring Timer List: SCAN_LoadMessageTimerValueList()
Application Range Open status
Function Reads the explicit client connection monitoring timer list from non-volatile
memory and registers it as the message monitoring timers.
Call Format BOOL SCAN_LoadMessageTimerValueList(DWORD Handle )
Type Name Contents
DWORD Handle Device handle obtained by SCAN_Open()
WORD MacId Desired node address
Setting range: 0x00 to 0x3F (0 to 63)
WORD* Epr Buffer address for obtaining the message monitor-
ing timer value (ms).
Type Name Contents
DWORD Handle Device handle obtained by SCAN_Open()