WM_CAP_FILE_SAVEDIB message

The WM_CAP_FILE_SAVEDIB message copies the current frame to a DIB file. You can send this message explicitly or by using the capFileSaveDIB macro.

WM_CAP_FILE_SAVEDIB 
wParam = (WPARAM) 0; 
lParam = (LPARAM) (LPVOID) (LPSTR) (szName); 

Parameters

szName

Pointer to the null-terminated string that contains the name of the destination DIB file.

Return Value

Returns TRUE if successful or FALSE otherwise.

If an error occurs and an error callback function is set using the WM_CAP_SET_CALLBACK_ERROR message, the error callback function is called.

Remarks

If the capture driver supplies frames in a compressed format, this call attempts to decompress the frame before writing the file.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Vfw.h

See also

Video Capture

Video Capture Messages