BM_WriteMultiple
Write multiple messages/events to the given channel.
BMAPI BM_StatusTypeDef BM_WriteMultiple (BM_ChannelHandle handle, const BM_DataTypeDef data[], uint32_t *nmessages, int timeout, uint32_t timestamp[])Parameters
Section titled “Parameters”| Direction | Name | Description |
|---|---|---|
| [in] | handle |
Handle to the channel to write to. |
| [in] | data |
A caller-allocated buffer to hold the messages/events array input, see BM_DataTypeDef for details. |
| [in,out] | nmessages |
Number of written messages, user shall initialize this param with the size (in messages) of the data buffer. |
| [in] | timeout |
Timeout (in milliseconds) before the message is transmitted successfully to the bus. Set any negative number (i.e. -1) to wait infinitely. Set 0 if you would like to transmit asynchronously: put to BMAPI internal buffer and return immediately, then receive TXCMPLT event over BM_Read() later. |
| [out] | timestamp |
The device local high precision timestamp array in microseconds, when the message is physically transmitted on the CAN bus, could be NULL if not required. |
Returns
Section titled “Returns”Operation status, see BM_StatusTypeDef for details.
This reference follows the current BUSMUST BMAPI SDK. For an installed package, its bundled header and help files define the exact version-specific contract.