ID2D1DeviceContext::CreateColorContextFromFilename-Methode (d2d1_1.h)
Erstellt einen Farbkontext, indem er aus dem angegebenen Dateinamen geladen wird. Die Profilbytes sind der Inhalt der Datei, die durch Filename angegeben wird.
Syntax
HRESULT CreateColorContextFromFilename(
PCWSTR filename,
[out] ID2D1ColorContext **colorContext
);
Parameter
filename
Typ: PCWSTR
Der Pfad zu der Datei, die die Profilbytes enthält, mit denen der Farbkontext initialisiert werden soll.
[out] colorContext
Typ: ID2D1ColorContext**
Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf einen neuen Farbkontext.
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. Das Modellfeld des Profilheaders wird überprüft, um festzustellen, ob es sich bei diesem Profil um sRGB oder scRGB handelt, und der Farbraum wird aktualisiert. Andernfalls ist der Speicherplatz benutzerdefiniert.
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 |