wglDescribeLayerPlane 関数 (wingdi.h)

[アーティクル]
08/27/2023

wglDescribeLayerPlane 関数は、指定されたピクセル形式のレイヤープレーンに関する情報を取得します。

構文

BOOL wglDescribeLayerPlane(
  HDC                    unnamedParam1,
  int                    unnamedParam2,
  int                    unnamedParam3,
  UINT                   unnamedParam4,
  LPLAYERPLANEDESCRIPTOR unnamedParam5
);

パラメーター

unnamedParam1

レイヤー平面を記述するウィンドウのデバイスコンテキストを指定します。

unnamedParam2

ピクセル形式のどのレイヤープレーンを記述するかを指定します。

unnamedParam3

オーバーレイまたはアンダーレイ平面を指定します。 iLayerPlane の正の値はオーバーレイ平面を識別します。ここで、1 はメイン平面上の最初のオーバーレイ平面、2 は最初のオーバーレイプレーン上の 2 番目のオーバーレイプレーンです。負の値を指定すると、アンダーレイ平面が識別されます。1 はメイン平面の下の最初の下敷き面、2 は最初のアンダーレイ平面の下の 2 番目のアンダーレイ平面です。オーバーレイ面とアンダーレイ平面の数は、PIXELFORMATDESCRIPTOR 構造体の bReserved メンバーで指定されます。

unnamedParam4

plpd が指す構造体のサイズをバイト単位で指定します。 wglDescribeLayerPlane 関数は、レイヤープレーンデータを LAYERPLANEDESCRIPTOR 構造体に格納し、nByte 以下のデータを格納します。 nBytes の値を LAYERPLANEDESCRIPTOR のサイズに設定します。

unnamedParam5

LAYERPLANEDESCRIPTOR 構造体を指します。 wglDescribeLayerPlane 関数は、構造体のデータメンバーの値を設定します。関数は、構造体にコピーされたデータのバイト数を nSize メンバーに格納します。

戻り値

関数が成功した場合、戻り値は TRUE になります。さらに、wglDescribeLayerPlane 関数は、指定したピクセル形式 (iPixelFormat) の指定されたレイヤープレーン (iLayerPlane) に従って、plpd によって指される LAYERPLANEDESCRIPTOR 構造体のメンバーを設定します。

関数が失敗した場合、戻り値は FALSE になります。

注釈

平面の番号付け (iLayerPlane ) によって順序が決まります。番号の大きい平面は、低い番号の平面をオーバーレイします。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h
Library	Opengl32.lib
[DLL]	Opengl32.dll