BM_ReadMultiple

函数名、签名、参数与返回值和 BMAPI SDK 保持一致，可直接用于开发、检索与代码审查。

Read multiple messages/events out of the given channel.

BMAPI BM_StatusTypeDef BM_ReadMultiple (BM_ChannelHandle handle, BM_DataTypeDef data[], uint32_t *nmessages, int timeout)

Parameters

Direction	Name	Description
[in]	handle	Handle to the channel to read from.
[out]	data	A caller-allocated buffer to hold the messages/events array output, see BM_DataTypeDef for details.
[in,out]	nmessages	Number of read messages, user shall initialize this param with the size (in messages) of the data buffer.
[in]	timeout	Timeout (in milliseconds) before the message is received successfully from the bus. Set any negative number (i.e. -1) to wait infinitely. Set 0 if you would like to receive asynchronously: read from BMAPI internal buffer and return immediately, use BM_WaitForNotifications() before reading.

Returns

Operation status, see BM_StatusTypeDef for details.

注意

This function is non-blocked, and thus will return BM_ERROR_QRCVEMPTY if not all messages are received. Please use notifications to wait for Rx events and then read message/event out of BMAPI internal RX buffer, otherwise you could also poll the device periodically.

---

This reference follows the current BUSMUST BMAPI SDK. For an installed package, its bundled header and help files define the exact version-specific contract.