IBasicVideo::GetVideoPaletteEntries

  • Article

This method retrieves the palette colors for the video.

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 Values

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.