ChoosePixelFormat 함수(wingdi.h)

ChoosePixelFormat 함수는 디바이스 컨텍스트에서 지원하는 적절한 픽셀 형식을 지정된 픽셀 형식 사양과 일치시키려고 시도합니다.

구문

int ChoosePixelFormat(
  HDC                         hdc,
  const PIXELFORMATDESCRIPTOR *ppfd
);

매개 변수

hdc

ppfd에서 가리키는 픽셀 형식 설명자에 가장 적합한 항목을 결정하기 위해 함수가 검사하는 디바이스 컨텍스트를 지정합니다.

ppfd

요청된 픽셀 형식을 지정하는 PIXELFORMATDESCRIPTOR 구조체에 대한 포인터입니다. 이 컨텍스트에서 ppfd가 가리키는 PIXELFORMATDESCRIPTOR 구조체의 멤버는 다음과 같이 사용됩니다.

반환 값

함수가 성공하면 반환 값은 지정된 픽셀 형식 설명자와 가장 가까운 픽셀 형식 인덱스(1 기반)입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

ChoosePixelFormat 함수와 일치하는 픽셀 형식이 요구 사항을 충족하는지 확인해야 합니다. 예를 들어 24비트 RGB 색 버퍼가 있는 픽셀 형식을 요청하지만 디바이스 컨텍스트에서 8비트 RGB 색 버퍼만 제공하는 경우 함수는 8비트 RGB 색 버퍼가 있는 픽셀 형식을 반환합니다.

예제

다음 코드 샘플에서는 ChoosePixelFormat 을 사용하여 지정된 픽셀 형식과 일치하는 방법을 보여줍니다.

PIXELFORMATDESCRIPTOR pfd = { 
    sizeof(PIXELFORMATDESCRIPTOR),  //  size of this pfd  
    1,                     // version number  
    PFD_DRAW_TO_WINDOW |   // support window  
    PFD_SUPPORT_OPENGL |   // support OpenGL  
    PFD_DOUBLEBUFFER,      // double buffered  
    PFD_TYPE_RGBA,         // RGBA type  
    24,                    // 24-bit color depth  
    0, 0, 0, 0, 0, 0,      // color bits ignored  
    0,                     // no alpha buffer  
    0,                     // shift bit ignored  
    0,                     // no accumulation buffer  
    0, 0, 0, 0,            // accum bits ignored  
    32,                    // 32-bit z-buffer      
    0,                     // no stencil buffer  
    0,                     // no auxiliary buffer  
    PFD_MAIN_PLANE,        // main layer  
    0,                     // reserved  
    0, 0, 0                // layer masks ignored  
    }; 
    HDC  hdc;
    int  iPixelFormat; 
 
iPixelFormat = ChoosePixelFormat(hdc, &pfd);

요구 사항

추가 정보

DescribePixelFormat

GetPixelFormat

Windows의 OpenGL

SetPixelFormat

Windows 함수