IBasicVideo::GetVideoPaletteEntries (Windows Embedded CE 6.0)

1/6/2010

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

Windows Embedded CE Windows CE 2.12 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

See Also

Reference

IBasicVideo Interface