DrvDescribePixelFormat 関数 (winddi.h)

DrvDescribePixelFormat 関数は、ピクセル形式の説明を PIXELFORMATDESCRIPTOR 構造体に書き込むことで、デバイス指定の PDEV のピクセル形式を記述します。

構文

LONG DrvDescribePixelFormat(
  DHPDEV                dhpdev,
  LONG                  iPixelFormat,
  ULONG                 cjpfd,
  PIXELFORMATDESCRIPTOR *ppfd
);

パラメーター

dhpdev

ピクセル形式情報が要求されるデバイスを識別します。

iPixelFormat

要求されたピクセル形式のインデックス番号を指定します。

cjpfd

ppfd が指す構造体に書き込むことができる最大バイト数を指定します。

ppfd

ピクセル形式に関する情報を受け取る PIXELFORMATDESCRIPTOR 構造体 (Microsoft Windows SDKドキュメントで説明) へのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

戻り値は、関数が成功した場合の最大ピクセル形式のインデックスです。 それ以外の場合は 0 になり、エラー コードがログに記録されます。

解説

3D グラフィックス ハードウェアをサポートするディスプレイ ドライバーは、1 つのディスプレイサーフェイスで異なるピクセル形式のウィンドウをサポートできます。 ピクセル形式は、グラフィックス ハードウェアでサポートされている構成に対応している必要があります。

このパラメーターが NULL でない場合、DrvDescribePixelFormat は ppfd が指す構造体を埋めます。

返される最大ピクセル形式インデックスは、デバイス コンテキストの最大ピクセル形式インデックスを取得する必要があるアプリケーションで使用できます。 デバイスがサポートするピクセル形式は、正の 1 から始まる整数インデックスによって識別されます。

ピクセル形式関数は、ウィンドウ オブジェクト サービス関数と組み合わせて使用して、表示サーフェイス上のウィンドウのピクセル形式を追跡および更新します。

要件