XLATEOBJ_cGetPalette関数 (winddi.h)

XLATEOBJ_cGetPalette関数は、指定したパレットから RGB 色またはビットフィールド形式を取得します。

構文

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

パラメーター

pxlo

GDI が要求された情報を取得する XLATEOBJ 構造体へのポインター。

[in] iPal

書き込むパレット情報を識別します。 このパラメーターには、次のいずれかの値を指定できます。

cPal

pPal が指すバッファー内のエントリの数を指定します。 これは、パレットの合計サイズよりも小さくすることができます。

pPal

GDI が要求されたパレット情報を書き込むバッファーへのポインター。 iPal がXO_SRCPALETTEまたはXO_DESTPALETTEで、それぞれのパレットの種類がPAL_INDEXED場合、各エントリは 24 ビット RGB 値になります。

iPal がXO_SRCBITFIELDSまたはXO_DESTBITFIELDSで、それぞれのパレットの種類がPAL_BITFIELDS、PAL_RGB、またはPAL_BGRの場合、pPal は赤、緑、青のカラー マスクを表す 3 つの ULONG マスクを指します。

戻り値

XLATEOBJ_cGetPaletteは 、 pPal が null でない場合に書き込まれたエントリの数を返します。 XLATEOBJ が null であるか、パレットが無効な場合は、0 の値が返されます。 pxlo が指すデータが iPal の値と一致しない場合も、XLATEOBJ_cGetPaletteは 0 を返します。 たとえば、指すデータがビットフィールドで、 iPal が XO_SRCPALETTE または XO_DESTPALETTE のいずれかに設定されている場合、 XLATEOBJ_cGetPalette は 0 を返します。 同様に、 pxlo が指すデータがパレットで、 iPal が XO_SRCBITFIELDS または XO_DESTBITFIELDS のいずれかに設定されている場合、 XLATEOBJ_cGetPalette も 0 を返します。

注釈

カラー ブレンドのいくつかの方法を実行するには、ドライバーにパレットに関する情報が必要です。

要件

こちらもご覧ください

XLATEOBJ