METODE ID2D1DeviceContext::CreateColorContext (d2d1_1.h)
Membuat konteks warna.
Sintaks
HRESULT CreateColorContext(
D2D1_COLOR_SPACE space,
[in, optional] const BYTE *profile,
UINT32 profileSize,
[out] ID2D1ColorContext **colorContext
);
Parameter
space
Jenis: D2D1_COLOR_SPACE
Ruang konteks warna untuk dibuat.
[in, optional] profile
Jenis: const BYTE*
Buffer yang berisi byte profil ICC yang digunakan untuk menginisialisasi konteks warna saat spasiD2D1_COLOR_SPACE_CUSTOM. Untuk jenis lain, parameter diabaikan dan harus diatur ke NULL.
profileSize
Jenis: UINT32
Ukuran dalam byte Profil.
[out] colorContext
Jenis: ID2D1ColorContext**
Ketika metode ini kembali, berisi alamat penunjuk ke objek konteks warna baru.
Nilai kembali
Jenis: HRESULT
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.
| HRESULT | Deskripsi |
|---|---|
| S_OK | Tidak terjadi kesalahan. |
| E_OUTOFMEMORY | Direct2D tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan panggilan. |
| E_INVALIDARG | Nilai yang tidak valid diteruskan ke metode . |
Keterangan
Konteks warna baru dapat digunakan dalam D2D1_BITMAP_PROPERTIES1 untuk menginisialisasi konteks warna bitmap yang dibuat.
Saat ruangD2D1_COLOR_SPACE_CUSTOM, profil dan profileSize harus ditentukan. Jika tidak, parameter ini harus diatur ke NULL dan nol masing-masing. Ketika ruang D2D1_COLOR_SPACE_CUSTOM, bidang model header profil diperiksa untuk menentukan apakah profil ini adalah sRGB atau scRGB dan ruang warna masing-masing diperbarui. Jika tidak, ruang tetap kustom.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2012 dan Platform Update untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | d2d1_1.h |
| DLL | D2d1.dll |