IltmmConvert::CanSaveObjectSettings

Summary

Determines whether the specified settings can be saved.

Syntax

#include "ltmm.h"

Language Syntax
C HRESULT IltmmConvert_CanSaveObjectSettings(pConvert, flags, pVal)
C++ HRESULT CanSaveObjectSettings(flags, pVal)

Parameters

IltmmConvert *pConvert

Pointer to an IltmmConvert interface.

long flags

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

VARIANT_BOOL *pVal

Pointer to a variable to be updated with a value that indicates whether the specified settings can be saved. Possible values are:

Value Meaning
VARIANT_TRUE The specified settings can be saved.
VARIANT_FALSE The specified settings can not be saved.

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. The convert object's settings can be saved to a file by calling IltmmConvert::SaveSettingsToFile.

Settings saved to a file can be loaded using IltmmConvert::LoadSettingsFromFile. Settings 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.

Multiple settings can be combined in the Flags parameter using the OR operator. However, please note that if settings are combined in the Flags parameter, all those settings must be capable of being saved in order for the CanSaveObjectSettings function to update the Status parameter with VARIANT_TRUE. If even one of those settings cannot be saved, then CanSaveObjectSettings will update the Status parameter with VARIANT_FALSE.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

Language Example
C IltmmConvert::CanSaveObjectSettings
C++ IltmmConvert::CanSaveObjectSettings
Help Version 22.0.2023.1.26
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 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.