IltmmCapture::SaveSettingsToStream

#include "ltmm.h"

C Syntax

HRESULT IltmmCapture_SaveSettingsToStream(pCapture, targetstream, flags)

C++ Syntax

HRESULT SaveSettingsToStream(targetstream, flags)

IltmmCapture *pCapture;

pointer to an interface

IUnknown * targetstream;

pointer to the stream object

long flags;

flags

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

Parameter

Description

pCapture

Pointer to an IltmmCapture interface.

targetstream

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

flags

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

Saved settings can be loaded using IltmmCapture::LoadSettingsFromFile or IltmmCapture::LoadSettingsFromStream.

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

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help