Metodo IDirectDrawPalette::GetCaps (ddraw.h)
Recupera le funzionalità dell'oggetto tavolozza.
Sintassi
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
Parametri
[out] unnamedParam1
Puntatore a una variabile che riceve un valore dal membro dwPalCaps della struttura DDCAPS che definisce le funzionalità del tavolozza. Questo valore è costituito da uno o più flag seguenti.
DDPCAPS_1BIT
L'indice è 1 bit. Nella tabella colori sono presenti due voci.
DDPCAPS_2BIT
L'indice è a 2 bit. Nella tabella colori sono presenti quattro voci.
DDPCAPS_4BIT
L'indice è a 4 bit. Nella tabella colori sono presenti 16 voci.
DDPCAPS_8BIT
L'indice è a 8 bit. Nella tabella colori sono presenti 256 voci.
DDPCAPS_8BITENTRIES
L'indice fa riferimento a un indice di colore a 8 bit. Questo flag è valido solo quando viene 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 per la tavolozza 8-bpp di una superficie di destinazione.
DDPCAPS_ALPHA
Il membro peFlags della struttura PALETTEENTRY associata deve essere interpretato come valore alfa a 8 bit singolo (oltre ai membri peRed, peGreen e peBlue ). Una tavolozza creata con questo flag può essere associata 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_PRIMARYSURFACE
Questa tavolozza è collegata alla superficie primaria. La modifica della tabella dei colori di questa tavolozza influisce immediatamente sulla visualizzazione a meno che non sia specificata DDPSETPAL_VSYNC e supportata.
DDPCAPS_PRIMARYSURFACELEFT
Questa tavolozza è quella associata alla superficie primaria a sinistra. La modifica della tabella dei colori di questa tavolozza influisce immediatamente sulla visualizzazione a sinistra, a meno che non sia specificata DDPSETPAL_VSYNC e supportata.
DDPCAPS_VSYNC
Questa tavolozza può avere modifiche sincronizzate con la frequenza di aggiornamento del monitoraggio.
Valore restituito
Se il metodo ha esito positivo, il valore restituito è DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |