choosePixelFormat 函数 (wingdi.h)

项目
08/27/2023

ChoosePixelFormat 函数尝试将设备上下文支持的相应像素格式与给定像素格式规范相匹配。

语法

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

参数

hdc

指定函数检查的设备上下文，以确定 ppfd 指向的像素格式描述符的最佳匹配。

ppfd

指向 PIXELFORMATDESCRIPTOR 结构的指针，该结构指定请求的像素格式。在此上下文中，ppfd 指向的 PIXELFORMATDESCRIPTOR 结构的成员按如下所示使用：

nSize	指定 PIXELFORMATDESCRIPTOR 数据结构的大小。将此成员设置为 `sizeof(PIXELFORMATDESCRIPTOR)`。
nVersion	指定 PIXELFORMATDESCRIPTOR 数据结构的版本号。将此成员设置为 1。
dwFlags	一组位标志，用于指定像素缓冲区的属性。可以使用按位 OR 组合以下位标志常量。如果设置了以下任何标志，则 ChoosePixelFormat 函数将尝试匹配同时设置了该标志或标志的像素格式。否则， ChoosePixelFormat 将忽略像素格式中的标志： PFD_DRAW_TO_WINDOW、 PFD_DRAW_TO_BITMAP、 PFD_SUPPORT_GDIPFD_SUPPORT_OPENGL 如果设置了以下任何标志， ChoosePixelFormat 将尝试匹配同时设置了该标志或标志的像素格式。否则，它会尝试匹配未设置该标志的像素格式： PFD_DOUBLEBUFFER PFD_STEREO 如果设置了以下标志，函数将忽略像素格式中的 PFD_DOUBLEBUFFER 标志： PFD_DOUBLEBUFFER_DONTCARE 如果设置了以下标志，函数将忽略像素格式中的 PFD_STEREO 标志： PFD_STEREO_DONTCARE
iPixelType	指定函数要考虑的像素格式类型： PFD_TYPE_RGBA、 PFD_TYPE_COLORINDEX
cColorBits	零或更大。
cRedBits	未使用。
cRedShift	未使用。
cGreenBits	未使用。
cGreenShift	未使用。
cBlueBits	未使用。
cBlueShift	未使用。
cAlphaBits	零或更大。
cAlphaShift	未使用。
cAccumBits	零或更大。
cAccumRedBits	未使用。
cAccumGreenBits	未使用。
cAccumBlueBits	未使用。
cAccumAlphaBits	未使用。
cDepthBits	零或更大。
cStencilBits	零或更大。
cAuxBuffers	零或更大。
iLayerType	指定以下层类型值之一：PFD_MAIN_PLANE、PFD_OVERLAY_PLANE、PFD_UNDERLAY_PLANE
bReserved	未使用。
dwLayerMask	未使用。
dwVisibleMask	未使用。
dwDamageMask	未使用。

返回值

如果函数成功，则返回值为像素格式索引 (从 1 开始的) 与给定像素格式描述符最匹配。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 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);

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h
Library	Gdi32.lib
DLL	Gdi32.dll