CreateCompatibleDC 함수(wingdi.h)

아티클
08/27/2023

CreateCompatibleDC 함수는 지정된 디바이스와 호환되는 DC(메모리 디바이스 컨텍스트)를 만듭니다.

구문

HDC CreateCompatibleDC(
  [in] HDC hdc
);

매개 변수

[in] hdc

기존 DC에 대한 핸들입니다. 이 핸들이 NULL이면 함수는 애플리케이션의 현재 화면과 호환되는 메모리 DC를 만듭니다.

반환 값

함수가 성공하면 반환 값은 메모리 DC에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다.

설명

메모리 DC는 메모리에만 존재합니다. 메모리 DC를 만들 때 디스플레이 화면은 단색 픽셀 너비와 단색 픽셀 높이가 정확히 1개입니다. 애플리케이션이 그리기 작업에 메모리 DC를 사용하려면 먼저 DC에 올바른 너비와 높이의 비트맵을 선택해야 합니다. DC에 비트맵을 선택하려면 CreateCompatibleBitmap 함수를 사용하여 필요한 높이, 너비 및 색 organization 지정합니다.

메모리 DC가 만들어지면 모든 특성이 일반 기본값으로 설정됩니다. 메모리 DC는 일반 DC로 사용할 수 있습니다. 특성을 설정할 수 있습니다. 특성의 현재 설정을 가져옵니다. 펜, 브러시 및 영역을 선택합니다.

CreateCompatibleDC 함수는 래스터 작업을 지원하는 디바이스에서만 사용할 수 있습니다. 애플리케이션은 GetDeviceCaps 함수를 호출하여 디바이스가 이러한 작업을 지원하는지 여부를 확인할 수 있습니다.

메모리 DC가 더 이상 필요하지 않은 경우 DeleteDC 함수를 호출합니다. DeleteDC를 호출하여 DC를 삭제하는 것이 좋습니다. 그러나 HDC를 사용하여 DeleteObject 를 호출하여 DC를 삭제할 수도 있습니다.

hdc가 NULL인 경우 CreateCompatibleDC를 호출하는 스레드는 생성된 HDC를 소유합니다. 이 스레드가 제거되면 HDC가 더 이상 유효하지 않습니다. 따라서 HDC를 만들고 다른 스레드에 전달한 다음 첫 번째 스레드를 종료하면 두 번째 스레드는 HDC를 사용할 수 없습니다.

Icm: 이 함수에 전달된 DC가 ICM(이미지 색 관리)에 대해 사용하도록 설정된 경우 함수에서 만든 DC는 ICM 사용입니다. 원본 및 대상 색 공간은 DC에 지정됩니다.

예제

예제는 이미지 캡처를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll