IltmmRTSPServer::LoadSettingsFromFile

Summary

Sets the default compression settings used for recompressing files whose compression is not compatible with the RTSP Server.

Syntax

#include "ltmm.h"

Parameters

IltmmRTSPServer *This

Pointer to the IltmmRTSPServer Interface.

long index

0-based index of the source folder whose default compression settings should be set.Use -1 to set the default compression settings for the RTSP server.

BSTR SourceFile

The source file containing the compression settings.

long Flags

Flags indicating which compression settings were saved in the file. For a list of possible values, refer to ltmmConvert_Settings constants.

Returns

Comments

The RTSP server will automatically recompress the audio or video stream in a file whose compression is not compatible with the RTSP server. See the LEAD RTSP Sink topic for the list of compressions supported by the RTSP server.

The SourceFile and Flags parameters are similar to the ones with same name in IltmmConvert::LoadSettingsFromFile. Only the compression settings for the video and audio compressor are loaded from the file. So, when necessary, the RTSP Server will call IltmmConvert::LoadSettingsFromFile(SourceFile, Flags & (ltmmConvert_Settings_AudioCompressors | ltmmConvert_Settings_VideoCompressors)) on the convert object doing the recompression.

While the server can recompress files on the fly, it is more efficient to make sure all the files have compatible compression settings to begin with to reduce the server load.

If index is between 0 and SourceCount - 1 (where SourceCount is the number of folders in the list, as indicated by IltmmRTSPServer::get_SourceCount), this function sets the compression settings for the source with the index equal to index.

If index is set to -1, this function sets the default compression settings for the RTSP server. All the current folders are set to these compression settings. Also, all future folders added with IltmmRTSPServer::put_SourceFolder will use the default compression settings.

If you never set the security settings for the RTSP server, the default compression settings are the ones saved in the registry for each default compressor.

These are the default compressors used at the moment:

• For incompatible Video streams: LEAD H264 Encoder (4.0)

• For incompatible Audio streams: LEAD AAC Encoder

You can also load the settings from a stream using IltmmRTSPServer::LoadSettingsFromStream. Note that this function cancels the compression settings set previously for the same index using IltmmRTSPServer::LoadSettingsFromStream.

Required DLLs and Libraries

• LTMM
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

See Also

Functions

• IltmmRTSPServer interface
• IltmmRTSPServer::LoadSettingsFromStream
• IltmmConvert::LoadSettingsFromFile

Topics

• Multimedia Function Groups
• Use IltmmRTSPServer to implement an RTSP Server