wglSwapLayerBuffers 函式 (wingdi.h)

wglSwapLayerBuffers函式會交換由指定裝置內容所參考之視窗重迭、底底和主要平面中的前端和後端緩衝區。

語法

BOOL wglSwapLayerBuffers(
  HDC  unnamedParam1,
  UINT unnamedParam2
);

參數

unnamedParam1

指定將圖層平面調色盤實現到實體調色盤之視窗的裝置內容。

unnamedParam2

指定要交換其前端和後端緩衝區的重迭、底下和主要平面。 PIXELFORMATDESCRIPTOR結構的bReserved成員會指定重迭和底底平面的數目。 fuPlanes參數是下列值的位元組合。

 

值	意義
WGL_SWAP_MAIN_PLANE	交換主要平面的前端和後端緩衝區。
WGL_SWAP_OVERLAYi	交換重迭平面 i的前後緩衝區，其中 i 是介於 1 到 15 之間的整數。 WGL_SWAP_OVERLAY1識別主要平面上的第一個重迭平面，WGL_SWAP_OVERLAY2識別第一個重迭平面上的第二個重迭平面，依此類推。
WGL_SWAP_UNDERLAYi	交換底下平面 i的前後緩衝區，其中 i 是介於 1 到 15 之間的整數。 WGL_SWAP_UNDERLAY1識別主要平面下的第一個底下平面，WGL_SWAP_UNDERLAY2識別第一個底下平面底下的第二個底底平面，依此類錯。

傳回值

如果函式成功，則傳回值為 TRUE。 如果函式失敗，傳回值為 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

當圖層平面不包含背景緩衝區時，呼叫 wglSwapLayerBuffers 函式不會影響該圖層平面。 呼叫 wglSwapLayerBuffers之後，背景緩衝區內容的狀態會在圖層平面的對應 LAYERPLANEDESCRIPTOR 結構或主要平面的 PIXELFORMATDESCRIPTOR 結構中提供。 wglSwapLayerBuffers函式會同時交換指定層平面中的前端和後端緩衝區。

某些裝置不支援個別交換圖層平面;他們會將所有圖層平面交換為群組。 設定 PIXELFORMATDESCRIPTOR 結構的PFD_SWAP_LAYER_BUFFERS旗標時，表示裝置可以交換個別圖層平面，而且您可以呼叫 wglSwapLayerBuffers。

使用多個執行緒的應用程式，在呼叫 wglSwapLayerBuffers之前，清除所有線程中繪製到相同視窗的所有繪圖命令。

規格需求

最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h
程式庫	Opengl32.lib
Dll	Opengl32.dll

另請參閱

LAYERPLANEDESCRIPTOR

Windows 上的 OpenGL

PIXELFORMATDESCRIPTOR

SwapBuffers

WGL 函式