Scanlab RTC6 PCIe Board - Release_Rtc

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
591
innovators for industry
Ctrl Command release_rtc
Function Releases the specified RTC6 for use by other user programs.
Call NoOfReleasedCard = release_rtc( CardNo )
Parameters CardNo RTC6 DLL-internal number of the RTC6 board.
As an unsigned 32-bit value.
Result The returned value is CardNo if the user program has been still in possession of access rights
for this board. Otherwise, 0 is returned.
As an unsigned 32-bit value.
Comments • After the user program releases a board with release_rtc, it no longer has access rights
for this board. The board can then be subsequently acquired by the same or another
user program by acquire_rtc or init_rtc6_dll.
• If a board released by release_rtc has been the active board, then (other than multi-
board commands) only those non-multi-board commands not requiring explicit access
rights are subsequently available. Another board is not automatically selected as the
active board. Activation of another board (for which access rights are assigned to the
user program) can be achieved by select_rtc.
• release_rtc is available even without explicit access rights for a particular RTC6 board,
but release_rtc then has no effect (return value 0).
• release_rtc also has no effect (return value 0), if:
– CardNo exceeds the number of RTC6 boards found during initialization (see
rtc6_count_cards) and
– No RTC6 Ethernet Board is entered at CardNo
– CardNo = 0 (real boards begin at 1)
• release_rtc is not available as a multi-board command.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References acquire_rtc, init_rtc6_dll