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 関数