#include "ltmf.h"
C Syntax |
HRESULT IltmfPlay_SaveStillBitmap(pPlay, filename, format, quality, flags, timeout) |
C++ Syntax |
HRESULT SaveStillBitmap(filename, format, qualty, flags, timeout) |
IltmfPlay *pPlay; |
pointer to an interface |
BSTR filename; |
file name |
long format; |
format |
long quality; |
compression quality |
long flags; |
flags |
long timeout; |
timeout |
Saves a snapshot from the running stream to a file, as a bitmap.
Parameter |
Description |
pPlay |
Pointer to an IltmfPlay interface. |
filename |
Character string containing the name of the file in which to save the bitmap. |
format |
Value that represents the output file format. For a list of possible values, refer to ltmfPlay_StillFormat Constants. |
quality |
Value that represents the compression quality. This is used only when the Format parameter is ltmfPlay_StillFormat_CMP. |
flags |
Not used. Pass 0. |
timeout |
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. |
S_OK |
The function was successful. |
<> S_OK |
An error occurred. Refer to the Error Codes or the HRESULT error codes in the MediaFoundation 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:
IltmfPlay::SaveStillDIB
Required DLLs and Libraries
LTMF 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: |
IltmfPlay::GetStillDIB, IltmfPlay::GetStillPicture, IltmfPlay::SaveStillDIB |
Topics: |
For a C++ example, refer to IltmfPlay::SaveStillBitmap 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.