Scanlab RTC6 PCIe Board - Eth_Get_Card_Info_Search

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
363
innovators for industry
Ctrl Command eth_get_card_info_search
Function Returns information about a particular RTC6 Ethernet Board in the search result list.
Call eth_get_card_info_search( SearchNo, Ptr )
Parameters SearchNo Index of the search result list.
As an unsigned 32-bit value.
Ptr Card information.
As a pointer (in C and C++ data type ULONG_PTR, an
unsigned 32-bit value or unsigned 64-bit value) to an array of 16 unsigned
32-bit values.
Result None.
Comments • eth_get_card_info_search is not available as a multi-board command.
• To create the search result list, use either eth_search_cards or
eth_search_cards_range. Their result value is the same as the one of
eth_found_cards. See also Chapter 16.5.2 ”About Searching RTC6 Ethernet Boards”,
page 904.
• For SearchNo = 0 and SearchNo > eth_found_cards a default information is returned.
Furthermore, the get_last_error return code RTC6_PARAM_ERROR is generated.
• If an search has not yet been carried-out then automatically the following applies:
SearchNo > eth_found_cards.
• For storage of the card information, the user program must provide (at the address
specified by Ptr ) a memory area of 16 × 4 bytes.
• Card information: Same as eth_get_card_info.
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 606, OUT 606, RBF 611.
References eth_found_cards, eth_get_card_info, eth_search_cards, eth_search_cards_range