cdiStartStatusMonitoring

Registers the caller to receive board status change events.

Prototype

DWORD cdiStartStatusMonitoring ( CTAHD ctahd)

Argument	Description
ctahd	Context handle.

Return values

Return value	Description
SUCCESS
CTAERR_INVALID_CTAHD	Handle is invalid.

Events

Event	Description
CDIEVN_BOARD_STATUS_CHANGE	The board status changed. Invoke cdiGetBoardStatus for details.

Details

Applications can register to receive events whenever the board status changes. To register an application, invoke cdiStartStatusMonitoring on a non-DSP port such as local:0:0. While you can monitor more than one context for a board, monitoring one context is sufficient and conserves system resources.

Any board status change generates CDIEVN_BOARD_STATUS_CHANGE. The application can then invoke cdiGetBoardStatus to determine what changed.

To unregister an application, invoke cdiStopStatusMonitoring.

Refer to Monitoring status changes for more information.