capPaletteOpen

  • Article

The capPaletteOpen macro loads a new palette from a palette file and passes it to a capture driver. Palette files typically use the filename extension .PAL. A capture driver uses a palette when required by the specified digitized image format. You can use this macro or explicitly call the WM_CAP_PAL_OPEN message.

BOOL capPaletteOpen(
  hwnd,  
  szName 
);

Parameters

hwnd

Handle to a capture window.

szName

Pointer to a null-terminated string containing the palette filename.

Return Values

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.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Capture, Video Capture Macros, capSetCallbackOnError, WM_CAP_PAL_OPEN