CreateCompatibleDC

CreateCompatibleDC

지정된 디바이스 콘텍스트에 관련하는 디바이스와 호환성이 있는 메모리데바이스콘테키스트를 작성합니다.

HDC CreateCompatibleDC(
    HDC hDC       // 디바이스 콘텍스트의 핸들
);

GDI32.DLL

인수

hDC

기존의 디바이스 콘텍스트의 핸들을 지정합니다.이 디바이스 콘텍스트에 관련하는 디바이스와 호환성이 있는 메모리데바이스콘테키스트를 작성합니다.0 (NULL) (을)를 지정하면, 어플리케이션의 현재의 스크린과 호환성이 있는 메모리데바이스콘테키스트가 작성됩니다.

반환값

성공하면 작성한 메모리데바이스콘테키스트의 핸들이 돌아갑니다.

실패하면0 (NULL) 하지만 돌아갑니다.

Windows NT/2000/XP： 확장 에러 정보를 취득하려면 , GetLastError함수를 사용합니다.

해설

메모리데바이스콘테키스트가 작성되면, 처음은1×1피크셀의 흑백 비트 맵이 선택된 상태가 되어 있습니다.어플리케이션은, 메모리데바이스콘테키스트를 사용해 묘화 조작을 행하기 전에, 올바른 사이즈의 비트 맵을 디바이스 콘텍스트에 선택하지 않으면 안됩니다.디바이스 콘텍스트에 선택하는 비트 맵을 작성하려면 , CreateCompatibleBitmap함수를 사용해 필요한 사이즈와 색형식을 지정합니다.

메모리데바이스콘테키스트가 작성되면, 모든 속성은 표준의 디폴트치로 설정됩니다.메모리데바이스콘테키스트에서는, 어플리케이션은 표준의 디바이스 콘텍스트와 같게 속성의 설정이나 취득, 펜·브러쉬·리젼의 선택을 행할 수 있습니다.

디바이스 콘텍스트가 불필요하게 되면 DeleteObject함수로 삭제하지 않으면 안됩니다.

Windows NT/2000/XP： hDC파라미터에0 (NULL) (을)를 지정하면, 호출 스렛드가 작성된 디바이스 콘텍스트의 핸들을 소유합니다.이 스렛드가 파기되면, 그 디바이스 콘텍스트의 핸들은 무효가 됩니다.그 때문에, 어느 스렛드가 그러한 디바이스 콘텍스트를 작성해 다른 스렛드에 건네주어, 그 후에 최초의 스렛드가 종료했을 경우에는,2번째의 스렛드는 그 핸들을 사용할 수 없게 됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후