References ▼
Saves a snapshot from the running stream to a file, as a bitmap.
#include "ltmm.h"
| Language | Syntax |
|---|---|
| C | HRESULT IltmmPlay_SaveStillBitmap(pPlay, filename, format, quality, flags, timeout) |
| C++ | HRESULT SaveStillBitmap(filename, format, quality, flags, timeout) |
Pointer to an IltmmPlay interface.
Character string containing the name of the file in which to save the bitmap.
Value that represents the output file format. For a list of possible values, refer to ltmmPlay_StillFormat Constants.
Value that represents the compression quality. This is used only when the Format parameter is ltmmPlay_StillFormat_CMP. For a list of possible values, refer to Compression Quality Factors.
Not used. Pass 0.
The timeout period in milliseconds. The function will fail if it was not able to take a sample in the specified time. Use 1 to wait indefinitely until a sample is snapped.
| 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. |
This method blocks (does not return) until the timeout occurs or the sample is snapped.
The following functions can also be used to obtain still images:
Win32, x64.
| Language | Example |
|---|---|
| C | IltmmPlay::SaveStillBitmap |
| C++ | IltmmPlay::SaveStillBitmap |
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