Collapse All Expand All

IltmmRTSPServer::LoadSettingsFromFile

#include "ltmm.h"

C Syntax	HRESULT IltmmRTSPServer_LoadSettingsFromFile(This, index, SourceFile, Flags)
C++ Syntax	HRESULT LoadSettingsFromFile(index, SourceFile, Flags)

 

IltmmFilterEnum *This;	/* pointer to the interface instance */
long index;	/* index of the source */
BSTR SourceFile;	/* the file containing the compressor settings */
long Flags;	/* flags indicating which compressor settings are in the file */

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

Parameter	Description
This	Pointer to the IltmmRTSPServer Interface.
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.
SourceFile	The source file containing the compression settings.
Flags	Flags indicating which compression settings were saved in the file. For a list of possible values, refer to ltmmConvert_Settings Constants.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

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

Elements:	IltmmRTSPServer interface, IltmmRTSPServer::LoadSettingsFromStream, IltmmConvert::LoadSettingsFromFile
Topics:	Multimedia Function Groups Use IltmmRTPServer to implement a RTSP Server