Looks up a board by its shelf and slot number and returns its name. This information is available only for CompactPCI CG boards in PICMG 2.1-compliant chassis.
DWORD oamBoardLookupByShelfSlot ( CTAHD ctahd, DWORD dwShelf, DWORD dwSlot, char *szName, DWORD dwNameSize )
|
Argument |
Description |
|
ctahd |
[in] Context handle. |
|
dwShelf |
[in] Shelf number of chassis containing board to look up. |
|
dwSlot |
[in] Slot number of board to look up. |
|
szName |
[out] Pointer to buffer to receive name of board. |
|
dwNameSize |
[in] Size of szName (maximum number of bytes to return including final null character). |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
szName is NULL or 0. |
|
CTAERR_SVR_COMM |
Natural Access Server is not running. |
|
OAMERR_NOT_ENOUGH_MEMORY |
Specified buffer size is too small. |
|
OAMERR_NOT_FOUND |
Board not found. |
|
OAMERR_SERVER_NOT_RUNNING |
Supervisor is shut down. |
oamBoardLookupByShelfSlot returns the name of the board with shelf and slot values dwShelf and dwShelf. Shelf and slot information is available only for CompactPCI CG boards in PICMG 2.1-compliant chassis.
dwShelf and dwShelf must be in the range 0 - 31 (5 bits).
For more information, see Retrieving board information.
oamBoardLookupByBusSlot, oamBoardLookupByDriverIDs, oamBoardLookupByMACAddress, oamBoardLookupByNumber, oamBoardLookupByProduct, oamBoardLookupBySerialNumber