#include "ltmm.h"
C Syntax |
HRESULT IltmmCapture_SaveSettingsToFile(pCapture, targetfile, flags) |
C++ Syntax |
HRESULT SaveSettingsToFile(targetfile, flags) |
IltmmCapture *pCapture; |
pointer to an interface |
BSTR targetfile; |
file name |
long flags; |
flags |
Saves some or all of the capture object's settings to a file. IltmmCapture::SaveSettingsToFile provides a convenient mechanism to save settings that can be retrieved at a later time.
Parameter |
Description |
pCapture |
Pointer to an IltmmCapture interface. |
targetfile |
Character string containing the name of the file in which to save the capture object's settings. |
flags |
Flags that indicate the saving options. For a list of possible values, refer to ltmmCapture_Settings Constants. |
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. |
The capture object's settings can be saved to a stream by calling IltmmCapture::SaveSettingsToStream.
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. |
Win32, x64
Elements: |
IltmmCapture::SaveSettingsToStream, IltmmCapture::LoadSettingsFromFile, IltmmCapture::LoadSettingsFromStream |
Topics: |
For a C example, refer to IltmmCapture::SaveSettingsToFile Example for C.
For a C++ example, refer to IltmmCapture::SaveSettingsToFile Example for C++.
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.