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
프로필의 크기(바이트) 입니다.
[out] colorContext
형식: ID2D1ColorContext**
이 메서드가 반환되면 새 색 컨텍스트 개체에 대한 포인터의 주소가 포함됩니다.
반환 값
형식: HRESULT
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
HRESULT | 설명 |
---|---|
S_OK | 오류가 발생하지 않았습니다. |
E_OUTOFMEMORY | Direct2D가 호출을 완료하기에 충분한 메모리를 할당할 수 없습니다. |
E_INVALIDARG | 잘못된 값이 메서드에 전달되었습니다. |
설명
D2D1_BITMAP_PROPERTIES1 새 색 컨텍스트를 사용하여 만든 비트맵의 색 컨텍스트를 초기화할 수 있습니다.
공간이D2D1_COLOR_SPACE_CUSTOM프로필 및 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 |