IltmmPlay::SaveSettingsToStream

#include "ltmm.h"

C Syntax

HRESULT IltmmPlay_SaveSettingsToStream(pPlay, pTargetStream, Flags)

C++ Syntax

HRESULT SaveSettingsToStream(pTargetStream, Flags)

 

IltmmPlay *pPlay;

/* pointer to an interface */

IUnknown * pTargetStream;

/* pointer to the stream object */

long Flags;

/* flags */

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

Parameter

Description

pPlay

Pointer to an IltmmPlay interface.

pTargetStream

Pointer to the stream object, an object that implements IStream, that will receive the player object's settings.

Flags

Flags that indicate the saving options. For a list of possible values, refer to ltmmPlay_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 player object's settings can be saved to a file by calling IltmmPlay::SaveSettingsToFile.

Saved settings can be loaded using IltmmPlay::LoadSettingsFromFile or 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.

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, Mobile

See Also

Elements:

IltmmPlay::SaveSettingsToFile, IltmmPlay::LoadSettingsFromFile, IltmmPlay::LoadSettingsFromStream

Topics:

Multimedia Function Group

Example

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

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