GetDeviceCaps 함수(wingdi.h)
GetDeviceCaps 함수는 지정된 디바이스에 대한 디바이스별 정보를 검색합니다.
구문
int GetDeviceCaps(
[in] HDC hdc,
[in] int index
);
매개 변수
[in] hdc
DC에 대한 핸들입니다.
[in] index
반환할 항목입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
| 인덱스 | 의미 | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
디바이스 드라이버 버전입니다. | ||||||||||||||||||||||||||||||||||
|
디바이스 기술. 다음 값 중 하나일 수 있습니다.
hdc 매개 변수가 향상된 메타파일의 DC에 대한 핸들인 경우 디바이스 기술은 CreateEnhMetaFile 함수에 지정된 참조된 디바이스의 핸들입니다. 향상된 메타파일 DC인지 확인하려면 GetObjectType 함수를 사용합니다. |
||||||||||||||||||||||||||||||||||
|
물리적 화면의 너비(밀리미터)입니다. | ||||||||||||||||||||||||||||||||||
|
물리적 화면의 높이(밀리미터)입니다. | ||||||||||||||||||||||||||||||||||
|
화면의 너비(픽셀)입니다. 또는 프린터의 경우 페이지의 인쇄 가능한 영역 너비(픽셀)입니다. | ||||||||||||||||||||||||||||||||||
|
높이, 래스터 라인, 화면; 또는 프린터의 경우 페이지의 인쇄 가능한 영역의 높이(픽셀)입니다. | ||||||||||||||||||||||||||||||||||
|
화면 너비를 따라 논리적 인치당 픽셀 수입니다. 여러 디스플레이 모니터가 있는 시스템에서 이 값은 모든 모니터에 대해 동일합니다. | ||||||||||||||||||||||||||||||||||
|
화면 높이를 따라 논리적 인치당 픽셀 수입니다. 여러 디스플레이 모니터가 있는 시스템에서 이 값은 모든 모니터에 대해 동일합니다. | ||||||||||||||||||||||||||||||||||
|
각 픽셀의 인접한 색 비트 수입니다. | ||||||||||||||||||||||||||||||||||
|
색 평면의 수입니다. | ||||||||||||||||||||||||||||||||||
|
디바이스별 브러시의 수입니다. | ||||||||||||||||||||||||||||||||||
|
장치별 펜 수입니다. | ||||||||||||||||||||||||||||||||||
|
디바이스별 글꼴 수입니다. | ||||||||||||||||||||||||||||||||||
|
디바이스의 색상 깊이가 픽셀당 8비트 이하인 경우 디바이스의 색 테이블에 있는 항목 수입니다. 색 깊이가 더 큰 디바이스의 경우 -1이 반환됩니다. | ||||||||||||||||||||||||||||||||||
|
선 그리기에 사용되는 디바이스 픽셀의 상대 너비입니다. | ||||||||||||||||||||||||||||||||||
|
선 그리기에 사용되는 디바이스 픽셀의 상대 높이입니다. | ||||||||||||||||||||||||||||||||||
|
선 그리기에 사용되는 디바이스 픽셀의 대각선 너비입니다. | ||||||||||||||||||||||||||||||||||
|
예약되어 있습니다. | ||||||||||||||||||||||||||||||||||
|
디바이스의 클리핑 기능을 나타내는 플래그입니다. 디바이스가 사각형에 클립할 수 있는 경우 1입니다. 그렇지 않으면 0입니다. | ||||||||||||||||||||||||||||||||||
|
시스템 팔레트의 항목 수입니다. 이 인덱스는 디바이스 드라이버가 RASTERCAPS 인덱스에서 RC_PALETTE 비트를 설정하고 드라이버가 16비트 Windows와 호환되는 경우에만 사용할 수 있는 경우에만 유효합니다. | ||||||||||||||||||||||||||||||||||
|
시스템 팔레트의 예약된 항목 수입니다. 이 인덱스는 디바이스 드라이버가 RASTERCAPS 인덱스에서 RC_PALETTE 비트를 설정하고 드라이버가 16비트 Windows와 호환되는 경우에만 사용할 수 있는 경우에만 유효합니다. | ||||||||||||||||||||||||||||||||||
|
디바이스의 실제 색 해상도(픽셀당 비트)입니다. 이 인덱스는 디바이스 드라이버가 RASTERCAPS 인덱스에서 RC_PALETTE 비트를 설정하고 드라이버가 16비트 Windows와 호환되는 경우에만 사용할 수 있는 경우에만 유효합니다. | ||||||||||||||||||||||||||||||||||
|
디바이스 인쇄의 경우: 물리적 페이지의 너비(디바이스 단위)입니다. 예를 들어 8.5-x11인치 용지의 600dpi로 인쇄하도록 설정된 프린터의 실제 너비 값은 5100 디바이스 단위입니다. 실제 페이지는 거의 항상 페이지의 인쇄 가능한 영역보다 크며 결코 작지 않습니다. | ||||||||||||||||||||||||||||||||||
|
디바이스 인쇄의 경우: 물리적 페이지의 높이(디바이스 단위)입니다. 예를 들어 8.5-by-11인치 용지의 600dpi로 인쇄할 프린터 집합의 물리적 높이 값은 6600 디바이스 단위입니다. 실제 페이지는 거의 항상 페이지의 인쇄 가능한 영역보다 크며 결코 작지 않습니다. | ||||||||||||||||||||||||||||||||||
|
디바이스 인쇄의 경우: 물리적 페이지의 왼쪽 가장자리에서 인쇄 가능한 영역의 왼쪽 가장자리까지의 거리(디바이스 단위)입니다. 예를 들어 맨 왼쪽 0.25인치 용지에 인쇄할 수 없는 8.5-by-11인치 용지의 600dpi로 인쇄할 프린터 집합의 가로 물리적 오프셋은 150개 장치 단위입니다. | ||||||||||||||||||||||||||||||||||
|
디바이스 인쇄의 경우: 물리적 페이지의 위쪽 가장자리에서 인쇄 가능한 영역의 위쪽 가장자리까지의 거리(디바이스 단위)입니다. 예를 들어 맨 위 0.5인치 용지에 인쇄할 수 없는 8.5-by-11인치 용지의 600dpi로 인쇄할 프린터 집합의 세로 물리적 오프셋은 300 디바이스 단위입니다. | ||||||||||||||||||||||||||||||||||
|
디스플레이 디바이스의 경우: 디바이스의 현재 세로 새로 고침 속도(초당 주기(Hz))입니다.
세로 새로 고침 빈도 값 0 또는 1은 디스플레이 하드웨어의 기본 새로 고침 속도를 나타냅니다. 이 기본 속도는 일반적으로 디스플레이 카드 또는 컴퓨터 마더보드의 스위치 또는 ChangeDisplaySettings와 같은 디스플레이 기능을 사용하지 않는 구성 프로그램에 의해 설정됩니다. |
||||||||||||||||||||||||||||||||||
|
프린터의 x축에 대한 배율 인수입니다. | ||||||||||||||||||||||||||||||||||
|
프린터의 y축에 대한 배율 인수입니다. | ||||||||||||||||||||||||||||||||||
|
여러 픽셀로 표현되는 기본 가로 그리기 맞춤입니다. 최상의 그리기 성능을 위해 창은 이 값의 배수에 가로로 정렬되어야 합니다. 값이 0이면 디바이스가 가속화되고 맞춤이 사용될 수 있음을 나타냅니다. | ||||||||||||||||||||||||||||||||||
|
디바이스의 음영 및 혼합 기능을 나타내는 값입니다. 추가 주석은 비고를 참조하세요.
|
||||||||||||||||||||||||||||||||||
|
다음 표와 같이 디바이스의 래스터 기능을 나타내는 값입니다.
|
||||||||||||||||||||||||||||||||||
|
다음 표와 같이 디바이스의 곡선 기능을 나타내는 값입니다.
|
||||||||||||||||||||||||||||||||||
|
다음 표와 같이 디바이스의 선 기능을 나타내는 값입니다.
|
||||||||||||||||||||||||||||||||||
|
다음 표와 같이 디바이스의 다각형 기능을 나타내는 값입니다.
|
||||||||||||||||||||||||||||||||||
|
다음 표와 같이 디바이스의 텍스트 기능을 나타내는 값입니다.
|
||||||||||||||||||||||||||||||||||
|
디바이스의 색 관리 기능을 나타내는 값입니다.
|
반환 값
반환 값은 원하는 항목의 값을 지정합니다.
nIndex가 BITSPIXEL이고 디바이스에 15bpp 또는 16bpp가 있는 경우 반환 값은 16입니다.
설명
nIndex가 SHADEBLENDCAPS인 경우:
- 프린터의 경우 GetDeviceCaps는 프린터에서 보고하는 내용을 반환합니다.
- 디스플레이 디바이스의 경우 모든 혼합 작업을 사용할 수 있습니다. SB_NONE 외에 SB_CONST_ALPHA 및 SB_PIXEL_ALPHA 반환 값만 있습니다. 이 값은 이러한 작업이 가속화되는지 여부를 나타냅니다.
참고 Display1은 일반적으로 기본 모니터이지만 항상 그렇지는 않습니다.
| 인덱스 | 프린터 이스케이프 교체됨 |
|---|---|
| PHYSICALWIDTH | GETPHYSPAGESIZE |
| PHYSICALHEIGHT | GETPHYSPAGESIZE |
| PHYSICALOFFSETX | GETPRINTINGOFFSET |
| PHYSICALOFFSETY | GETPHYSICALOFFSET |
| SCALINGFACTORX | GETSCALINGFACTOR |
| SCALINGFACTORY | GETSCALINGFACTOR |
참고GetDeviceCaps는 표시 드라이버가 제공하는 정보를 보고합니다. 디스플레이 드라이버가 정보 보고를 거부하는 경우 GetDeviceCaps 는 고정 계산에 따라 정보를 계산합니다. 표시 드라이버가 잘못된 정보를 보고하면 GetDeviceCaps 에서 잘못된 정보를 반환합니다. 또한 디스플레이 드라이버가 정보 보고를 거부하는 경우 GetDeviceCaps 는 고정 DPI(96 DPI) 또는 고정 크기(디스플레이 드라이버가 수행하고 제공하지 않은 정보에 따라 다름)를 가정하기 때문에 잘못된 정보를 계산할 수 있습니다. 아쉽게도 WDDM(Windows Display Driver Model)에 구현된 디스플레이 드라이버(Windows Vista에서 도입됨)는 GDI가 정보를 얻지 못하므로 GetDeviceCaps 는 항상 정보를 계산해야 합니다.
예제
예를 들어 인쇄 준비를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h(Windows.h 포함) |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기