Funzione EngQueryPalette (winddi.h)
La funzione EngQueryPalette esegue una query sul riquadro specificato per gli attributi.
Sintassi
ENGAPI ULONG EngQueryPalette(
HPALETTE hpal,
ULONG *piMode,
ULONG cColors,
ULONG *pulColors
);
Parametri
hpal
Handle nella tavolozza da eseguire una query.
piMode
Puntatore a una posizione che riceve la modalità tavolozza, come originariamente specificato in EngCreatePalette.
cColors
Specifica il numero di voci nel buffer a cui punta pulColors . Il valore restituito dipende dal fatto che cColors sia negativo.
pulColors
Puntatore a un buffer che riceve le informazioni sul colore della tavolozza. Se cColors è zero, pulColors può essere NULL.
Valore restituito
Quando cColors è zero, EngQueryPalette restituisce il numero di voci della tavolozza necessarie nel buffer in cui pulColors punta per restituire le informazioni sul colore della tavolozza. Quando cColors è diverso da zero e pulColors non è NULL, EngQueryPalette restituisce il numero di voci scritte nel buffer a cui punta pulColors .
Commenti
Se la modalità tavolozza è PAL_BITFIELDS, PAL_RGB o PAL_BGR e il buffer che pulColors punta a è abbastanza grande, pulColors punta a tre maschere ULONG che rappresentano le maschere di colore rosso, verde e blu della tavolozza.
Se la modalità tavolozza è PAL_INDEXED e il buffer che pulColors punta a è abbastanza grande, pulColors contiene tutti i valori RGB a 24 bit che rappresentano i colori della tavolozza.
Un driver deve testare la presenza del flag di GCAPS_PALMANAGED per determinare se i colori rappresentano una tavolozza fissa o modificabile.
EngQueryPalette è destinato all'uso da parte dei driver di mirroring che devono conoscere il formato del colore della visualizzazione primaria. Un driver di mirroring chiama in genere questa funzione nella routine DrvEnablePDEV .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |