updateStatus

updateStatus -- forces the card flags to be read and processed.

Synopsis

(updateStatus [card_id])
  

Parameters

card_id

The target card ID (0..3). If no card ID is specified, the query is repeated for all initialized cards.

Returns

    (updateStatus card_id status)

where status is the status byte for the card (see defineStatusPoint), or one of the following errors:

    (error "updateBuffers -1 (time) Command invalid: Card card_id using interrupt mode")
    
    (error "updateBuffers DR_ERR_DEV_INVALID (time) invalid device: card_id")
    
    (error "updateBuffers DR_ERR_DEV_IO_FAILURE (time) I/O failure (error_code) on device card_id")
Note

The text string corresponding to the error message code for I/O failure can be obtained by issuing a errorDescription command, like this:

    (errorDescription error_code)

Description

This command causes the card status flags to be read, and processed if a change is detected, returning the resulting status of the card. Typically, you would use this command as an alternative to the normal mechanisms for updating the card, namely, polling (see cardPoll) or interrupts, when you want to synchronize the processing of card events externally.

See Also

updateBuffers

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.