ADM-XRC SDK 2.8.1 User Guide (Linux)
© Copyright 2001-2009 Alpha Data
Prototype
ADMXRC_STATUS ADMXRC_OpenCard( ADMXRC_DEVICE_NUM CardID, ADMXRC_HANDLE* Card);
Arguments
Argument | Type | Purpose |
CardID | In | ID of card to open |
Card | Out | Handle to opened card |
Return value
Value | Meaning |
ADMXRC_SUCCESS | The card was successfully opened |
ADMXRC_CARD_NOT_FOUND | The card was in use or not physically present |
Description
This function is used to open and obtain a handle to an ADM-XRC card.
The particular card to open is identified by its card ID, passed via the CardID parameter. If there is more than one card in the system with the same ID, the function will open the first free card found with the specified ID. If the special value 0 is used for CardID, the first card found that is not in use will be opened, regardless of its ID.
The handle returned in the Card parameter should be used in all further API calls that need to access this card. When access to the card is no longer required, call ADMXRC_CloseCard to close the handle and free the card.