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:

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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Multimedia C API Help