Omron 3G8F7-CRM21, Руководство пользователя

Страница: 96 / 238

76
Board Control API Section A-2
A-2 Board Control API
A-2-1 CPNT_Open (Open Board)
Purpose Open the Board that has the specified ID, and enable it for use.
Call Format HANDLE CPNT_Open(WORD BoardId) ;
Argument
Returned value When the function succeeds, the open device handle is returned.
If it fails or when no Board with the specified ID exists,
INVALID_HANDLE_VALUE is returned.
Then use the function GetLastError to obtain detailed error content.
Remarks
•
The Board must be opened first in order to be used.
•
One Board can be opened only by one application or one process.
•
The Board ID is the value set by the rotary switch on the Board.
A-2-2 CPNT_Close (Close Board)
Purpose Close the Board which has the specified ID, and disable it to use.
Call Format BOOL CPNT_Close(HANDLE Handle) ;
Argument
Returned value It returns TRUE when the function succeeds.
It returns FALSE when an error occurs. The error details can be obtained with
the function GetLastError.
Remarks With this function, the Board is reset at the same time when the device handle
is closed.
All data that has been set is cleared.
Be sure to complete any processes required for the application prior to this
function.
A-2-3 CPNT_Reset (Reset Board)
Purpose Rest the Board of the specified device handle.
Call Format BOOL CPNT_Reset(HANDLE Handle) ;
Argument
Type Parameter Direction Description
WORD BoardId IN ID of Board to be opened Specified
range: 0x0 to 0x9 (0 to 9)
Type Parameter Direction Description
HANDLE Handle IN Device handle obtained with the
function CPNT_Open
Type Parameter Direction Description
HANDLE Handle IN Device handle obtained with the
function CPNT_Open