ID2D1DeviceContext::CreateColorContext-Methode (d2d1_1.h)

Erstellt einen Farbkontext.

Syntax

HRESULT CreateColorContext(
                 D2D1_COLOR_SPACE  space,
  [in, optional] const BYTE        *profile,
                 UINT32            profileSize,
  [out]          ID2D1ColorContext **colorContext
);

Parameter

space

Typ: D2D1_COLOR_SPACE

Der zu erstellende Farbkontext.

[in, optional] profile

Typ: const BYTE*

Ein Puffer, der die ICC-Profilbytes enthält, die zum Initialisieren des Farbkontexts verwendet werden, wenn leer D2D1_COLOR_SPACE_CUSTOM ist. Bei anderen Typen wird der Parameter ignoriert und sollte auf NULL festgelegt werden.

profileSize

Typ: UINT32

Die Größe von Profile in Byte.

[out] colorContext

Typ: ID2D1ColorContext**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf ein neues Farbkontextobjekt.

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Hinweise

Der neue Farbkontext kann in D2D1_BITMAP_PROPERTIES1 verwendet werden, um den Farbkontext einer erstellten Bitmap zu initialisieren.

Wenn spaceD2D1_COLOR_SPACE_CUSTOM ist, müssen profile und profileSize angegeben werden. Andernfalls sollten diese Parameter auf NULL bzw. Null festgelegt werden. Wenn der Bereich D2D1_COLOR_SPACE_CUSTOM ist, wird das Modellfeld des Profilheaders überprüft, um festzustellen, ob dieses Profil sRGB oder scRGB ist und der Farbraum aktualisiert wird. Andernfalls bleibt der Speicherplatz benutzerdefinierter.

Anforderungen

Weitere Informationen

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext