CImagePalette::ShouldUpdate

 
Microsoft DirectShow 9.0

CImagePalette::ShouldUpdate

The ShouldUpdate method determines whether it is necessary to create a new palette.

Syntax

  BOOL ShouldUpdate(
    const VIDEOINFOHEADER *pNewInfo,
    const VIDEOINFOHEADER *pOldInfo
);

Parameters

pNewInfo

Pointer to a VIDEOINFOHEADER structure containing the new color table.

pOldInfo

Pointer to a VIDEOINFOHEADER structure containing the old color table. This parameter can be NULL.

Return Value

Returns TRUE if the palette needs to be updated, or FALSE otherwise.

Remarks

  • If neither VIDEOINFOHEADER structure contains a color table, the method returns FALSE.
  • If only one structure contans a color table, or if pOldInfo is NULL, the method returns TRUE.
  • If both structures contain color tables, and the color entries match, the method returns FALSE.
  • If both structures contain color tables, but the color entries do not match, the method returns TRUE.

Requirements

**  Header:** Declared in Winutil.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also