Init_Rtc6_Dll - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command init_rtc6_dll
Function Initializes control of the installed RTC6 boards for a user program.
InitErrorNo = init_rtc6_dll()
Call
Result Error code.
As an unsigned 32-bit value.
If multiple errors occurred simultaneously, then multiple bits are set.
The assignment between bit numbers, error types and error constants is identical to those
for get_error.
Comments • init_rtc6_dll must be called by each user program at the beginning, so that an
RTC6 board can be addressed by the user program at all.
• init_rtc6_dll searches for all present RTC6 PCIe Boards
(not for RTC6 Ethernet Boards! – see
Boards", page 904
If no RTC6 board is found (for example, when only RTC6 Ethernet Boards are
operated), then error code
• init_rtc6_dll automatically assigns the user program access rights to the found boards
(as by acquire_rtc), if access rights are not already assigned to another user program
(any number of boards and applications may be used, but each particular board cannot
be used simultaneously by multiple applications). The first initialization acquires all
found boards for itself. Subsequent initializations started by other applications result
in return of an
only accessible by these applications through
no access rights – for example, get_error,
board commands, too, are only callable for boards with existing access rights). If a
user program has access rights for a board, then the user program must first explicitly
release its access rights with
by another user program by init_rtc6_dll or acquire_rtc.
RTC6_ACCESS_DENIED
An
of the found boards. Which board(s) denied access can be determined by
n_get_error( CardNo ) (CardNo from 1 to the number of found boards) or directly after
init_rtc6_dll (before the next command) by n_get_last_error( CardNo ) .
• If a board is acquired by init_rtc6_dll (as by acquire_rtc), then a version compatibility
check is performed. If a version error is detected, then access to the board is denied
(return code RTC6_ACCESS_DENIED|RTC6_VERSION_MISMATCH).
• Only one user program can perform initialization at any one time. Subsequent
initializations started by other applications wait until the current initialization is
complete.
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
Chapter 16.5.2 "About Searching RTC6 Ethernet
on this topic) and establishes the RTC6 board management.
RTC6_NO_PCIE_CARD_FOUND
RTC6_ACCESS_DENIED error code by init_rtc6_dll. The boards are then
release_rtc
or
error code is returned if access has been denied by at least one
is returned (see get_error).
RTC6 DLL-internal functions that require
get_last_error or select_rtc
free_rtc6_dll
before the board can be used
(most multi-
464