Share via

ID2D1EffectContext::CreateColorContext-Methode (d2d1effectauthor.h)

  • Artikel

Erstellt einen Farbkontext aus einem Farbraum.

Wenn der Farbraum Benutzerdefiniert ist, wird der Kontext aus den Parametern profile und profileSize initialisiert.

Wenn der Farbraum nicht Benutzerdefiniert ist, wird der Kontext mit den Profilbytes initialisiert, die dem Farbraum zugeordnet sind. Die Parameter profile und profileSize werden ignoriert.

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.

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 d2d1effectauthor.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1EffectContext