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_GDI、PFD_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	未使用。

傳回值

如果函式成功，則傳回值是像素格式索引， (一個基底) 最符合指定的像素格式描述元。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	wingdi.h
程式庫	Gdi32.lib
Dll	Gdi32.dll