
Orange Tree Technologies
Page 28 of 57
11 Host Library Function Reference
ZestSC1CountCards
ZESTSC1_STATUS ZestSC1CountCards( unsigned long *NumCards,
unsigned long *CardIDs,
unsigned long *SerialNumbers,
ZESTSC1_FPGA_TYPE *FPGATypes);
Parameters
NumCards Pointer to location to receive total number of ZestSC1 cards in
the system.
CardIDs Pointer to buffer to receive list of card IDs in the system. May
be NULL.
SerialNumbers Pointer to buffer to receive list of card serial numbers in the
system. May be NULL.
FPGATypes Pointer to buffer to receive list of FPGA types fitted to cards in
the system. May be NULL.
Return Value
ZESTSC1_SUCCESS Function succeeded
ZESTSC1_INTERNAL_ERROR An unspecified internal error occurred while
communicating with the driver
Description
ZestSC1CountCards can be used to determine the number and types of cards fitted in a
system. Each card can be identified in 3 ways: by a user-programmable card ID, by a
factory set unique serial number and by the type of FPGA fitted to the card.
CardIDs should point to the start of an array which will be filled in with the user
programmable card IDs. See ZestSC1SetCardID for details of how to set this ID. This
ID should be passed to ZestSC1OpenCard to obtain a handle for accessing the selected
ZestSC1 card.
SerialNumbers should point to the start of an array which will be filled in with the factory
set, unique serial number of the cards in the system.
FPGATypes should point to the start of an array which will be filled in with the type of
FPGA fitted.
Each of these arrays should be large enough to receive values for each of the cards in the
system. Any or all of them can be NULL if the information is not required. A call to
ZestSC1CountCards can be made with NULL pointers to determine the size of the
required array as follows:
Comentários a estes Manuais