ADM-XRC SDK 2.8.1 User Guide (Linux)
© Copyright 2001-2009 Alpha Data


ADMXRC2_OpenCard

Prototype

ADMXRC2_STATUS
ADMXRC2_OpenCard(
    ADMXRC2_CARDID  CardID,
    ADMXRC2_HANDLE* Card);

Arguments

Argument Type Purpose
CardID In ID of card to open
Card Out Handle to opened card

Return value

Value Meaning
ADMXRC2_SUCCESS The card was successfully opened
ADMXRC2_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 ADMXRC2_CloseCard to close the handle and free the card.

 


 Top of page