Saves a snapshot from the running stream to a file, as a bitmap.
|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.
|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:
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries