ID2D1DeviceContext::CreateColorContextFromFilename-Methode (d2d1_1.h)

  • Artikel

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

Weitere Informationen

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext