Sensoray 2251 Rev.A - Manual (Page 7)

4. If recording is required, it is initiated by a call to SN_StartRecord(), and stopped with a
call to SN_StopRecord().
5. During the recording the following functions could be used to obtain some useful
information:
• SN_GetStatus() – current status (record, playback), current recorded file size
and path;
• SN_GetTimeLeft() - returns estimated recording time left on disk;
• SN_IsEnoughSpace() - returns true if enough space to record at specified
bitrate for length of time specified (estimate).
6. SN_Close() must be called before application terminates to clean up properly.
Demo applications
The SDK includes several applications provided with the source code to illustrate the use of SDK’s
functions.
DemoApp – an MFC application. Displays the stream in the window, allows modification of compression,
video, and audio parameters, recording the stream to the hard drive.
DemoCallback – A simple console application showing the use of the 2250 SDK in callback mode. This
can be used for Motion JPEG capture or MPEG capture. The predefined Preview, record, and some other
functionality (Snapshot to file) are not supported in this mode. This mode was defined for possibly
embedded applications, which just want to retrieve data. The callback should return quickly and MUST
not block. See the functions SN_StartCBCaptureOnly, SN_StopCBCaptureOnly, SN_RegisterAudCB,
Sn_RegisterVidCB in mid2250func.h and the source code include in the SDK.
DemoMotionJpeg – a simple console application. Records a given number of JPEG frames to the hard
drive without display. Does not require installation of ffdshow. Demonstrates simple MotionJpeg capture
only. An alternative using callbacks is shown in DemoCallback
DemoConsoleApp – console application using the 2250 SDK
DemoMpegCap – demonstrate MPEG only mode. Another way to get MPEG only or MotionJpeg only is
using callbacks (see DemoCallback)
DemoVB6 – demonstrates the basics of using the SDK in Visual Basic 6
DemoVBNet – demonstrates the basics of using the SDK in Visual Studio .NET 2003(or higher)
Functions Reference
All API functions are declared using the following definition:
7