DescribePixelFormat 함수(wingdi.h)
DescribePixelFormat 함수는 hdc와 연결된 디바이스의 iPixelFormat으로 식별되는 픽셀 형식에 대한 정보를 가져옵니다. 함수는 ppfd가 가리키는 PIXELFORMATDESCRIPTOR 구조체의 멤버를 해당 픽셀 형식 데이터로 설정합니다.
구문
int DescribePixelFormat(
HDC hdc,
int iPixelFormat,
UINT nBytes,
LPPIXELFORMATDESCRIPTOR ppfd
);
매개 변수
hdc
디바이스 컨텍스트를 지정합니다.
iPixelFormat
픽셀 형식을 지정하는 인덱스입니다. 디바이스 컨텍스트에서 지원하는 픽셀 형식은 양의 1 기반 정수 인덱스로 식별됩니다.
nBytes
ppfd가 가리키는 구조체의 크기(바이트)입니다. DescribePixelFormat 함수는 해당 구조체에 n바이트 이하의 데이터를 저장합니다. 이 값을 sizeof(PIXELFORMATDESCRIPTOR)로 설정합니다.
ppfd
함수가 픽셀 형식 데이터로 설정하는 멤버인 PIXELFORMATDESCRIPTOR 구조체에 대한 포인터입니다. 함수는 구조체의 nSize 멤버에서 구조체에 복사된 바이트 수를 저장합니다. 입력 시 ppfd 가 NULL이면 함수는 구조체에 데이터를 쓰지 않습니다. 디바이스 컨텍스트의 최대 픽셀 형식 인덱스만 가져오려는 경우에 유용합니다.
반환 값
함수가 성공하면 반환 값은 디바이스 컨텍스트의 최대 픽셀 형식 인덱스입니다. 또한 함수는 지정된 픽셀 형식에 따라 ppfd가 가리키는 PIXELFORMATDESCRIPTOR 구조체의 멤버를 설정합니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |