Rockwell Automation Allen-Bradley ControlLogix 1756-MVI - Page 44

Publication 1756-RM004B-EN-P - October 2000
3-22 MVI Backplane API
MVIbp_GetProcessorStatus
Syntax:
int MVIbp_GetProcessorStatus(MVIHANDLE handle, WORD
*pstatus);
Parameters:
handle handle returned by previous call to MVIbp_Open
pstatus pointer to a word that will be updated with the current
processor status
Description:
This function is used to query the state of the processor. handle must
be a valid handle returned from MVIbp_Open.
pstatus is a pointer to an word. When this function returns, certain bits
in this word will be set to indicate the current processor status, as
shown in table 3.G.
1756_MVI Note
The data connection must be established in order to receive the
processor status. Therefore, if the data connection is not established,
this function will return MVI_ERR_BADCONFIG and
pstatus will be
zero.
1794-MVI Note
This function is not supported on the 1794-MVI and will always return
MVI_ERR_NOTSUPPORTED.
Return Value:
MVI_SUCCESS no errors were encountered
MVI_ERR_NOACCESS
handle does not have access
MVI_ERR_BADCONFIG the data connection is not open. (1756-MVI
only)
Table 3.G - Processor Status Bits
Bit Name Description
0 MVI_PROCESSOR_STATUS_RUN
Set if processor is in Run mode.
1 MVI_DATA_CONNECTION_OPEN Set if data connection is open (1756-MVI
only).
2 MVI_STATUS_CONNECTION_OPEN Set if status connection is open (1756-MVI
only)