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 |