Returns the shelf and slot for the board with the given name. This information is available only for CompactPCI CG boards in PICMG 2.1-compliant chassis.
DWORD oamBoardGetShelfSlot ( CTAHD ctahd, const char *szName, DWORD *pdwShelf, DWORD *pdwSlot )
|
Argument |
Description |
|
ctahd |
[in] Context handle. |
|
szName |
[in] Pointer to the name of board to look up. |
|
pdwShelf |
[out] Pointer to the shelf number of the chassis containing the board. |
|
pdwSlot |
[out] Pointer to the board's slot number. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
szName, pdwShelf, or pdwSlot is NULL or 0. |
|
CTAERR_SVR_COMM |
Natural Access Server is not running. |
|
OAMERR_NOT_FOUND |
Board not found. |
|
OAMERR_SERVER_NOT_RUNNING |
Supervisor is shut down. |
oamBoardGetShelfSlot returns the shelf and slot values of board szName.Shelf. Shelf and slot information is available only for CompactPCI CG boards in a PICMG 2.1-compliant chassis.
Shelf and slot values are coded in 5 bits each, so pdwShelf and pdwSlot are both values between 0 and 31. If shelf and slot values cannot be retrieved (for example, if board szName is a PCI board), pdwShelf and pdwSlot are set to illegal value 32.
For more information, see Retrieving board information.
oamBoardGetBusSlot, oamBoardGetDriverIDs, oamBoardGetMACAddress, oamBoardGetNumber, oamBoardGetProduct, oamBoardGetSerialNumber, oamBoardGetStatus