funzione XLATEOBJ_cGetPalette (winddi.h)

La funzione XLATEOBJ_cGetPalette recupera i colori RGB o il formato bitfields dalla tavolozza specificata.

Sintassi

ENGAPI ULONG XLATEOBJ_cGetPalette(
       XLATEOBJ *pxlo,
  [in] ULONG    iPal,
       ULONG    cPal,
       ULONG    *pPal
);

Parametri

pxlo

Puntatore alla struttura XLATEOBJ da cui GDI recupera le informazioni richieste.

[in] iPal

Identifica le informazioni sulla tavolozza da scrivere. Questo parametro può essere uno dei valori seguenti:

cPal

Specifica il numero di voci nel buffer a cui fa riferimento pPal. Può essere inferiore alla dimensione totale della tavolozza.

pPal

Puntatore a un buffer in cui GDI scrive le informazioni sul tavolozza richieste. Se iPal è XO_SRCPALETTE o XO_DESTPALETTE e il rispettivo tipo di tavolozza è PAL_INDEXED, ogni voce è un valore RGB a 24 bit.

Se iPal è XO_SRCBITFIELDS o XO_DESTBITFIELDS e il rispettivo tipo di tavolozza è PAL_BITFIELDS, PAL_RGB o PAL_BGR, pPal punta a tre maschere ULONG che rappresentano le maschere di colore rosso, verde e blu.

Valore restituito

XLATEOBJ_cGetPalette restituisce il numero di voci scritte se pPal non è null. Viene restituito un valore pari a zero se xLATEOBJ è null o la relativa tavolozza non è valida. XLATEOBJ_cGetPalette restituirà anche zero se i dati puntati da pxlo non sono coerenti con il valore in iPal. Ad esempio, se i dati a cui puntano è un campo bit, ma iPal è impostato su XO_SRCPALETTE o XO_DESTPALETTE, XLATEOBJ_cGetPalette restituirà zero. Analogamente, se i dati puntati da pxlo sono una tavolozza, ma iPal è impostato su XO_SRCBITFIELDS o XO_DESTBITFIELDS, XLATEOBJ_cGetPalette restituisce anche zero.

Commenti

Il driver deve avere informazioni sulla tavolozza per eseguire alcuni metodi di fusione dei colori.

Requisiti

Vedi anche

XLATEOBJ