Available in LEADTOOLS Imaging Pro, Vector, Document, and Medical Imaging toolkits. |
L_WiaAcquireImageFromVideo
#include "ltwia.h"
L_LTWIA_API L_INT EXT_FUNCTION L_WiaAcquireImageFromVideo(hSession, pszFileName, puLength)
HWIASESSION hSession; |
/* handle to an existing WIA session */ |
L_TCHAR* pszFileName; |
/* pointer to a string buffer to be updated */ |
L_SIZE_T* puLength; |
/* pointer to a variable that contains the user allocated string buffer length */ |
Extracts a still image from the video stream, and saves the image as a JPEG file.
Parameter |
Description |
hSession |
Handle to an existing WIA session. This handle is obtained by calling the L_WiaInitSession function. |
pszFileName |
Receives the full path and filename of the JPEG file that this method creates. |
puLength |
Pointer to a variable that contains the user allocated string buffer length. This parameter will always be updated with the exact required string buffer length. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This feature is available in version 16 or higher.
To retrieve the required string buffer length, declare a variable of type L_SIZE_T and pass the address of that variable to this function and also pass NULL for the pszFileName parameter. Then you can use the returned buffer length to allocate your string buffer with the exact required buffer length. But still this function will save the image to the images directory in this case.
Required DLLs and Libraries
LTWIA 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
Since WIA does not support video devices in Windows Server 2003, Windows Vista or later, then this function will only work with Windows XP or earlier operating systems.
See Also
Functions: |
L_WiaStartVideoPreview, L_WiaResizeVideoPreview, L_WiaEndVideoPreview, L_WiaIsVideoPreviewAvailable, L_WiaInitSession, L_WiaEndSession. |
Topics: |
|
|
Example
For an example, refer to L_WiaIsVideoPreviewAvailable.