Metodo IDirectDraw7::CreatePalette (ddraw.h)

Crea un oggetto DirectDrawPalette per questo oggetto DirectDraw.

Sintassi

HRESULT CreatePalette(
  [in]  DWORD               unnamedParam1,
  [in]  LPPALETTEENTRY      unnamedParam2,
  [out] LPDIRECTDRAWPALETTE *unnamedParam3,
  [in]  IUnknown            *unnamedParam4
);

Parametri

[in] unnamedParam1

Questo valore è costituito da uno o più flag seguenti:

DDPCAPS_1BIT

L'indice è 1 bit. Nella tabella dei colori sono presenti due voci.

DDPCAPS_2BIT

L'indice è a 2 bit. Nella tabella dei colori sono presenti quattro voci.

DDPCAPS_4BIT

L'indice è a 4 bit. Nella tabella dei colori sono presenti 16 voci.

DDPCAPS_8BIT

L'indice è a 8 bit. Nella tabella dei colori sono presenti 256 voci.

DDPCAPS_8BITENTRIES

L'indice fa riferimento a un indice di colore a 8 bit. Questo flag è valido solo se usato con il flag DDPCAPS_1BIT, DDPCAPS_2BIT o DDPCAPS_4BIT e quando la superficie di destinazione è 8 bpp. Ogni voce di colore è lunga 1 byte ed è un indice della tavolozza 8 bpp di una superficie di destinazione.

DDPCAPS_ALPHA

Il membro peFlags della struttura PALETTEENTRY associata deve essere interpretato come un singolo valore alfa a 8 bit (oltre ai membri peRed, peGreen e peBlue ). Una tavolozza creata usando questo flag può essere collegata solo a una trama: una superficie creata con il flag di funzionalità DDSCAPS_TEXTURE.

DDPCAPS_ALLOW256

Questa tavolozza può avere tutte le 256 voci definite.

DDPCAPS_INITIALIZE

Obsoleta. DirectDraw inizializza sempre questa tavolozza con i colori nella matrice di colori passata a lpDDColorArray.

DDPCAPS_PRIMARYSURFACE

Questa tavolozza è collegata alla superficie primaria. La modifica della tabella dei colori di questa tavolozza influisce immediatamente sullo schermo, a meno che non venga specificato e supportato DDPSETPAL_VSYNC.

DDPCAPS_PRIMARYSURFACELEFT

Questa tavolozza è quella associata alla superficie primaria dell'occhio sinistro. La modifica della tabella dei colori di questa tavolozza influisce immediatamente sullo schermo a sinistra, a meno che non venga specificato e supportato DDPSETPAL_VSYNC.

DDPCAPS_VSYNC

Questa tavolozza può avere modifiche sincronizzate con la frequenza di aggiornamento del monitor.

[in] unnamedParam2

Indirizzo di una matrice di strutture 2, 4, 16 o 256 PALETTEENTRY per inizializzare l'oggetto DirectDrawPalette.

[out] unnamedParam3

Indirizzo di una variabile da impostare su un puntatore di interfaccia IDirectDrawPalette valido se la chiamata ha esito positivo.

[in] unnamedParam4

Consente la compatibilità futura con le funzionalità di aggregazione COM. Attualmente, questo metodo restituisce un errore se questo parametro non è NULL.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene DD_OK.

Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_NOCOOPERATIVELEVELSET
• DDERR_OUTOFMEMORY
• DDERR_UNSUPPORTED

Requisiti

Vedi anche

IDirectDraw7