IltmmConvert::SaveSettingsToFile

Summary

Saves some or all of the capture object's settings to a file..

Syntax

#include "ltmm.h"

Language Syntax
C HRESULT IltmmConvert_SaveSettingsToFile(pConvert, targetfile, flags)
C++ HRESULT SaveSettingsToFile(targetfile, flags)

Parameters

IltmmConvert *pConvert

Pointer to an IltmmConvert interface.

BSTR targetfile

Character string containing the name of the file in which to save the convert object's settings.

long flags

Flags that indicate the saving options. For a list of possible values, refer to ltmmConvert_Settings constants.

Returns

Value Meaning
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 stream by calling IltmmConvert::SaveSettingsToStream.

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

Platforms

Win32, x64.

See Also

Functions

Topics

Example

Language Example
C IltmmConvert::SaveSettingsToFile
C++ IltmmConvert::SaveSettingsToFile
Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.