ID2D1DeviceContext::CreateColorContext メソッド (d2d1_1.h)
カラー コンテキストを作成します。
構文
HRESULT CreateColorContext(
D2D1_COLOR_SPACE space,
[in, optional] const BYTE *profile,
UINT32 profileSize,
[out] ID2D1ColorContext **colorContext
);
パラメーター
space
種類: D2D1_COLOR_SPACE
作成する色コンテキストのスペース。
[in, optional] profile
型: const BYTE*
スペースがD2D1_COLOR_SPACE_CUSTOMされたときにカラー コンテキストを初期化するために使用される ICC プロファイル バイトを含むバッファー。 その他の型の場合、 パラメーターは無視され、 NULL に設定する必要があります。
profileSize
型: UINT32
Profile のサイズ (バイト単位)。
[out] colorContext
種類: ID2D1ColorContext**
このメソッドから制御が戻るときに、新しいカラー コンテキスト オブジェクトへのポインターのアドレスが格納されます。
戻り値
型: HRESULT
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生していません。 |
| E_OUTOFMEMORY | Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。 |
| E_INVALIDARG | 無効な値が メソッドに渡されました。 |
注釈
新しいカラー コンテキストを D2D1_BITMAP_PROPERTIES1 で使用して、作成されたビットマップのカラー コンテキストを初期化できます。
スペースがD2D1_COLOR_SPACE_CUSTOM場合は、profile と profileSize を指定する必要があります。 それ以外の場合は、これらのパラメーターをそれぞれ NULL と 0 に設定する必要があります。 スペースがD2D1_COLOR_SPACE_CUSTOMされると、プロファイル ヘッダーのモデル フィールドが検査され、このプロファイルが sRGB か scRGB かを判断し、色空間がそれぞれ更新されます。 それ以外の場合、スペースはカスタムのままです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d2d1_1.h |
| [DLL] | D2d1.dll |