Share via

D3DHAL_DP2UPDATEPALETTE

  • Article

This structure is used when responding to the D3DDP2OP_UPDATEPALETTE opcode in D3dDrawPrimitives2. It is used to make alterations to the palette that is used for palletized textures.

typedef struct _D3DHAL_DP2UPDATEPALETTE {
  DWORD dwPaletteHandle;
  WORD wStartIndex;
  WORD wNumEntries;
} D3DHAL_DP2UPDATEPALETTE, *LPD3DHAL_DP2UPDATEPALETTE;

Members

  • dwPaletteHandle
    Is a handle to the palette to be altered.
  • wStartIndex
    Specifies the index in the palette beyond which data will be updated.
  • wNumEntries
    Specifies the number of PALETTEENTRYs being updated.

Remarks

The palette handle attached to a surface is updated with wNumEntries PALETTEENTRYs starting at a specific wStartIndex member of the palette. A PALETTEENTRY (defined in Wingdi.h and Wtypes.h) is actually a DWORD with an ARGB color for each byte.

After the D3DHAL_DP2UPDATEPALETTE structure in the command stream, the actual palette data will follow (without any padding), consisting of one DWORD per palette entry (in ARGB format, with 8 bits for each of the four channels). There will only be one D3DHAL_DP2UPDATEPALETTE structure (plus palette data) following the D3DHAL_DP2COMMAND structure regardless of the value of wStateCount (a member of the D3DHAL_DP2COMMAND structure).

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3dhal.h.

See Also

D3DDP2OP_UPDATEPALETTE | D3dDrawPrimitives2 | PALETTEENTRY | D3DHAL_DP2COMMAND | D3DHAL_XXX Structures

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.