structure D3DHAL_DP2SETPALETTE (d3dhal.h)

  • Article

La structure D3DHAL_DP2SETPALETTE est utilisée pour associer une palette à une texture lorsqu’un pilote répond à D3DDP2OP_SETPALETTE dans D3dDrawPrimitives2. Cet opcode permet de mapper une association entre un handle de palette et un handle de surface, et de spécifier les caractéristiques de la palette.

Syntaxe

typedef struct _D3DHAL_DP2SETPALETTE {
  DWORD dwPaletteHandle;
  DWORD dwPaletteFlags;
  DWORD dwSurfaceHandle;
} D3DHAL_DP2SETPALETTE;

Membres

dwPaletteHandle

Spécifie un handle pour la palette à configurer. Si la valeur est zéro, la surface spécifiée par dwSurfaceHandle doit être dissociée de toute palette à laquelle elle a pu être associée précédemment.

dwPaletteFlags

Spécifie un ensemble d’indicateurs qui spécifient les attributs de la palette. |Indicateur|Signification| |--- |--- | |DDRAWIPAL_2|La palette comporte 2 entrées. Actuellement inutilisé.| |DDRAWIPAL_4|La palette comporte 4 entrées. Actuellement inutilisé.| |DDRAWIPAL_16|La palette comporte 16 entrées. Actuellement inutilisé.| |DDRAWIPAL_256|La palette comporte 256 entrées. Actuellement inutilisé.| |DDRAWIPAL_ALLOW256|La palette peut être entièrement mise à jour. Actuellement inutilisé.| |DDRAWIPAL_ALPHA|Le canal de données alpha de la palette est valide et doit être utilisé.| |DDRAWIPAL_DIRTY|La palette a été modifiée de sorte que la palette GDI n’est pas synchronisée. Actuellement inutilisé.| |DDRAWIPAL_EXCLUSIVE|La palette est utilisée en mode exclusif. Actuellement inutilisé.| |DDRAWIPAL_GDI|La palette est allouée via GDI. Actuellement inutilisé.| |DDRAWIPAL_INHEL|La palette est effectuée dans la hel (couche d’émulation matérielle). Actuellement inutilisé.| |DDRAWIPAL_STORED_8|La palette est stockée à l’aide de 8 bpp par entrée. Actuellement inutilisé.| |DDRAWIPAL_STORED_16|La palette est stockée à l’aide de 16 bpp par entrée. Actuellement inutilisé.| |DDRAWIPAL_STORED_24|La palette est stockée à l’aide de 24 bpp par entrée. Actuellement inutilisé.| |DDRAWIPAL_STORED_8INDEX|La palette est stockée sous forme d’index 8 bits dans une palette de destination. Actuellement inutilisé.|

dwSurfaceHandle

Spécifie un handle à la surface Direct3D (texture) à laquelle cette palette (identifiée par dwPaletteHandle) est associée.

Remarques

Le nombre de structures D3DHAL_DP2SETPALETTE à suivre est spécifié par le membre wStateCount de la structure D3DHAL_DP2COMMAND qui les précède dans le flux de commandes.

Configuration requise

Condition requise Valeur
En-tête d3dhal.h (inclure D3dhal.h)

Voir aussi

D3DDP2OP_SETPALETTE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2