Find Free Cards

Description

Obtains the logical bus and slot locations of installed cards that are operable by the Pilpxi driver and are currently unopened. These values are used with PIPLX_OpenSpecifiedCard.

Prototype

DWORD PIPLX_FindFreeCards(SESSION session, DWORD NumCards, DWORD *BusList, DWORD *SlotList);

Parameters:

Session - The session variable obtained from the PICMLX_Connect call

NumCards - the number of cards (maximum) for which information is to be obtained

BusList - pointer to the one-dimensional array (vector) to receive cards' bus location values

SlotList - pointer to the one-dimensional array (vector) to receive cards' slot location values

Returns:

Zero for success, or non-zero error code.

Notes

The bus and slot locations of the first card found are placed respectively in the least significant elements of the BusList and SlotList arrays. Successive elements contain the values for further cards.

If the value given for NumCards is less than the number of cards currently accessible, information is obtained only for the number of cards specified.

Warning

The arrays pointed to must have been assigned at least as many elements as the number of cards for which information is being requested or adjacent memory will be overwritten, causing data corruption and/or a program crash. The number of accessible cards can be discovered using PIPLX_CountFreeCards.