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.

HRESULT	BESCHREIBUNG
S_OK	Kein Fehler ist aufgetreten.
E_OUTOFMEMORY	Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG	Ein ungültiger Wert wurde an die -Methode übergeben.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1_1.h
DLL	D2d1.dll

Weitere Informationen

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext