ID2D1EffectContext::CreateColorContext-Methode (d2d1effectauthor.h)
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 |