In This Topic ▼

IltmmConvert::SaveSettingsToStream

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert_SaveSettingsToStream(pConvert, targetstream, flags)
C++ Syntax	HRESULT SaveSettingsToStream(targetstream, flags)

IltmmConvert *pConvert;	pointer to an interface
IUnknown * targetstream;	pointer to the stream object
long flags;	flags

Saves some or all of the convert object's settings to a stream..

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
targetstream	Pointer to the stream object, an object that implements IStream, that will receive the convert object's settings.
flags	Flags that indicate the saving options. 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 convert object's settings can be saved to a file by calling IltmmConvert::SaveSettingsToFile.

Settings that have been saved to a file can be loaded using IltmmConvert::LoadSettingsFromFile. Settings that have been saved to a stream can be loaded using IltmmConvert::LoadSettingsFromStream.

It may be helpful to call IltmmConvert::CanSaveObjectSettings before calling either IltmmConvert::SaveSettingsToFile or [IltmmConvert:SaveSettingsToStream, to make sure the settings you want to save can be saved. If either IltmmConvert::SaveSettingsToFile or IltmmConvert::SaveSettingsToStream is called for settings that cannot be saved, the save function will fail.

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

Example

For a C example, refer to IltmmConvert::SaveSettingsToStream Example for C.

For a C++ example, refer to IltmmConvert::SaveSettingsToStream Example for C++.

Download our FREE evaluation

Help Version 21.0.2021.7.19

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

Multimedia Files You Must Include With Your Application (Redistributables)

Frequently Asked Questions

LEADTOOLS Multimedia Features

Add-on Modules

Programming with LEADTOOLS Multimedia

Appendix

LEADTOOLS Licensing

Elements:	IltmmConvert::SaveSettingsToFile, IltmmConvert::LoadSettingsFromFile, IltmmConvert::LoadSettingsFromStream
Topics:	Multimedia Function Group