Edit

Share via


capFileAlloc macro (vfw.h)

The capFileAlloc macro creates (preallocates) a capture file of a specified size. You can use this macro or explicitly send the WM_CAP_FILE_ALLOCATE message.

Syntax

BOOL capFileAlloc(
     hwnd,
     dwSize
);

Parameters

hwnd

Handle to a capture window.

dwSize

Size, in bytes, to create the capture file.

Return value

Type: BOOL

Returns TRUE if successful or FALSE otherwise.If an error occurs and an error callback function is set using the capSetCallbackOnError macro, the error callback function is called.

Remarks

You can improve streaming capture performance significantly by preallocating a capture file large enough to store an entire video clip and by defragmenting the capture file before capturing the clip.

Requirements

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

See also

Video Capture

Video Capture Macros