BM_GetNotification

Get the platform/OS independent notification handle for the given channel, so that the application could wait for notifications later.

BMAPI BM_StatusTypeDef BM_GetNotification (BM_ChannelHandle handle, BM_NotificationHandle *notification)

Parameters

Direction	Name	Description
[in]	handle	Handle to the channel that owns the notification handle.
[out]	notification	The platform/OS independent notification handle.

Returns

Operation status, see BM_StatusTypeDef for details.

Note

By using notification handles in a background thread, it is easy to implement an asynchronous message receiver as below: channel = BM_OpenCan(…);

BM_GetNotification(channel, notification);

while (!exit) {

BM_WaitForNotifications(&notification, 1, -1); // Wait infinitely for new message notification.

BM_ReadCanMessage(…);

}

---

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