GetDC

GetDC

지정된 윈도우의 클라이언트 영역 또는 스크린 전체에 대응하는 디스플레이 디바이스 콘텍스트의 핸들을 취득합니다.

HDC GetDC(
    HWND hWnd     // 윈도우 핸들
);

USER32.DLL

인수

hWnd

디바이스 콘텍스트를 취득하는 윈도우의 핸들을 지정합니다. 0 (NULL) (을)를 지정하면, 스크린 전체의 디바이스 콘텍스트를 취득합니다.

Windows 98/Me/2000/XP： 이 파라미터에 0 (NULL) (을)를 지정하면, 프라이머리 디스플레이 모니터의 디바이스 콘텍스트를 취득합니다.다른 디스플레이 모니터의 디바이스 콘텍스트를 취득하려면 EnumDisplayMonitors 함수와 CreateDC 함수를 사용합니다.

반환값

성공하면 디바이스 콘텍스트의 핸들이 돌아갑니다.

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

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

해설

이 함수는, 디스플레이 디바이스 콘텍스트(코먼 디바이스 콘텍스트, 클래스 디바이스 콘텍스트, 프라이빗 디바이스 콘텍스트의 언젠가.지정된 윈도우의 클래스 스타일에 따라서 타입이 다르다)의 핸들을 취득합니다.클래스 디바이스 콘텍스트 및 프라이빗 디바이스 콘텍스트에서는, 이전에 할당할 수 있었던 디바이스 콘텍스트의 속성은 그대로입니다만, 코먼 디바이스 콘텍스트에서는, 이전에 할당할 수 있었던 속성은 핸들 취득마다 디폴트에 되돌려집니다.

코먼 디바이스 콘텍스트에 의한 묘화가 종료하면, ReleaseDC 함수로 디바이스 콘텍스트를 해방하지 않으면 안됩니다. ReleaseDC 함수는, GetDC 함수를 호출한 스렛드에 의해서 불려 가지 않으면 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후