Win32 API 日本語リファレンス
ホーム › Devices.Display › PFN_DrvDescribePixelFormat

PFN_DrvDescribePixelFormat

コールバック

シグネチャ

INT PFN_DrvDescribePixelFormat(
    DHPDEV param0,
    INT param1,
    DWORD param2,
    PIXELFORMATDESCRIPTOR* param3
);

パラメーター

フィールド型
param0DHPDEV
param1INT
param2DWORD
param3PIXELFORMATDESCRIPTOR*

公式ドキュメント

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

戻り値

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

解説(Remarks)

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

ppfd が NULL でない場合、DrvDescribePixelFormat はこのパラメーターが指す構造体に情報を格納します。

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

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)