Funzione DrvSetPalette (winddi.h)

Articolo
08/27/2023

La funzione DrvSetPalette richiede al driver di realizzare la tavolozza per un dispositivo specificato.

Sintassi

BOOL DrvSetPalette(
  DHPDEV dhpdev,
  PALOBJ *ppalo,
  FLONG  fl,
  ULONG  iStart,
  ULONG  cColors
);

Parametri

dhpdev

Gestire la struttura PDEV del dispositivo fisico, che identifica il dispositivo la cui tavolozza deve essere realizzata. Questo parametro è l'handle del dispositivo restituito a GDI da DrvEnablePDEV.

ppalo

Puntatore alla struttura PALOBJ su cui devono essere sottoposti a query i colori (valori RGB).

fl

Set di flag che fornisce hint e opzioni. Questo parametro può essere il valore seguente:

Valore	Significato
SP_DEFAULT	La tavolozza è la tavolozza predefinita completa del dispositivo. Il PALOBJ può essere ignorato, ma contiene il contenuto corretto.

iStart

Specifica il primo indice della tavolozza da sovrascrivere.

cColors

Specifica il numero di colori da modificare nella tavolozza hardware. I colori aggiuntivi, oltre il numero disponibile nell'hardware, possono essere ignorati. Se cColors è inferiore alla dimensione della tavolozza hardware, impostare solo le voci cColors e lasciare invariati i colori rimanenti.

Valore restituito

Il valore restituito è TRUE se la funzione ha esito positivo. In caso contrario, è FALSE e viene registrato un codice di errore.

Commenti

Il driver imposta la tavolozza hardware in modo che corrisponda alle voci nella tavolozza specificata il più possibile.

È possibile realizzare solo le tavolozze indicizzate. Il RC_PALETTE bit del membro flRasterCaps della struttura GDIINFO specifica se un dispositivo ha una tavolozza realizzabile.

DrvSetPalette è necessario per i driver di visualizzazione che supportano tavolozze realizzabili.