Add Bookmark
The Add Bookmark command allows you to add a bookmark to the last frame currently in the capture buffer at the time the command is processed OR optionally to a specified frame number.
A string representing the bookmark id must be specified using the String= parameter specification.
Add Bookmark;String=Bookmark#1
A bookmark must not already exist for the frame or a failure notification response is sent:
Add Bookmark;FAILED;Timestamp=1/30/2013 10:18:01 AM;Reason=Frame already has bookmark
An optional frame number may be specified to set a bookmark on a specific frame.
Add Bookmark;String=Bookmark#1;Frame=1024
The frame number must be valid or a failure notification response is sent:
Add Bookmark;FAILED;Timestamp=1/30/2013 10:15:17 AM;Reason=Frame does not exist
When a bookmark is successfully added, the response notification will contain the frame number that the bookmark was added to. The following example shows that a bookmark was added to frame #3066.
Add Bookmark;SUCCEEDED;Frame=3066;Timestamp=1/30/2013 10:17:58 AM