IltmmPlay::CanSaveObjectSettings

#include "ltmm.h"

C Syntax

HRESULT IltmmPlay_CanSaveObjectSettings(pPlay, flags, pVal)

C++ Syntax

HRESULT CanSaveObjectSettings(flags, pVal)
IltmmPlay pPlay;

pointer to an interface

long flags;

flags

VARIANT_BOOL pVal;

pointer to a variable

Determines whether the specified settings can be saved.

Parameter Description
pCapture Pointer to an IltmmPlay interface.
flags Flags that indicate the settings to check. For a list of possible values, refer to the ltmmPlay_Settings constants.
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

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

Settings saved to a file can be loaded using IltmmPlay::LoadSettingsFromFile. Settings saved to a stream can be loaded using IltmmPlay::LoadSettingsFromStream.

It may be helpful to call IltmmPlay::CanSaveObjectSettings before calling either IltmmPlay::SaveSettingsToFile or IltmmPlay::SaveSettingsToStream, to make sure the settings you want to save can be saved. If either IltmmPlay::SaveSettingsToFile or IltmmPlay::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

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
Introduction
Version History
Getting Started
Copyright Notice
Directories
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