Share via


IBasicVideo::GetVideoPaletteEntries (Compact 2013)

3/26/2014

This method retrieves the palette colors for the video.

Syntax

HRESULT GetVideoPaletteEntries(
  long StartIndex,
  long Entries,
  long* pRetrieved,
  long* pPalette
);

Parameters

  • StartIndex
    [in] Start index for the palette.
  • Entries
    [in] Number of palette entries required.
  • pRetrieved
    [out] Number of entries actually returned.
  • pPalette
    [out] Pointer to an array of Win32 PALETTEENTRY structures.

Return Value

Returns an HRESULT value.

Remarks

An application can query the colors required by the video with this method.

An application can pass in a null pPalette parameter, and the pRetrieved parameter is filled in with the number of colors in use.

The pPalette parameter is a pointer to an array of PALETTEENTRY structures.

With the StartIndex and Entries parameters, an application can request any contiguous section of the palette in a single method.

The interface was modeled on the Win32 GetSystemPaletteEntries function.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IBasicVideo Interface