
ZestSC1 User Guide
CONFIDENTIAL Page 31 of 57
ZestSC1GetCardInfo
ZESTSC1_STATUS ZestSC1GetCardInfo( ZESTSC1_HANDLE Handle,
ZESTSC1_CARD_INFO *Info);
Parameters
Handle Handle of open ZestSC1 card. See ZestSC1OpenCard.
Info Pointer to structure to receive information about the card.
Return Value
ZESTSC1_SUCCESS Function succeeded
ZESTSC1_INTERNAL_ERROR An unspecified internal error occurred while
communicating with the driver
ZESTSC1_ILLEGAL_HANDLE Attempt to use illegal card handle
ZESTSC1_TIMEOUT Operation timed out
Description
ZestSC1GetCardInfo can be used to obtain information about an open card. The
ZESTSC1_CARD_INFO structure is defined as follows:
typedef struct
{
unsigned long CardID;
unsigned long SerialNumber;
ZESTSC1_FPGA_TYPE FPGAType;
Unsigned long MemorySize;
unsigned long TimeOut;
} ZESTSC1_CARD_INFO;
CardID is a user-programmable ID for the card. See ZestSC1CountCards for details of
how to find the IDs of cards in the system and ZestSC1SetCardID for details of how to
set this ID.
SerialNumber is a unique, factory-set serial number for the card.
FPGAType gives the type of FPGA fitted to the card.
MemorySize gives the number of bytes of SRAM fitted to the card.
TimeOut is the length of time, in milliseconds, that blocking operations should wait for
before returning ZESTSC1_TIMEOUT. Time outs allow the user program to recover
cleanly when communication with the card fails. See ZestSC1SetTimeOut for details of
how to set this time.
For example:
ZESTSC1_HANDLE Handle;
Comentarios a estos manuales