DrvCreateDeviceBitmap 関数 (winddi.h)

DrvCreateDeviceBitmap 関数は、ビットマップを作成および管理します。

構文

HBITMAP DrvCreateDeviceBitmap(
  DHPDEV dhpdev,
  SIZEL  sizl,
  ULONG  iFormat
);

dhpdev

アプリケーションがビットマップのプライマリターゲットとして指定した物理デバイスを記述する PDEV を処理します。ビットマップの形式は、この物理デバイスと互換性がある必要があります。

sizl

作成するビットマップの幅と高さを含む SIZEL 構造体を指定します。この構造体の cx メンバーと cy メンバーには、ビットマップの幅と高さがピクセル単位でそれぞれ含まれます。 SIZEL 構造体は SIZE 構造体と同じです。

iFormat

ビットマップ形式を指定します。これは、ピクセルあたりの色情報の必要なビット数を示し、常にプライマリの形式と一致します。この値は、次のいずれかです。

戻り値は、関数が成功した場合に作成されたビットマップを識別するハンドルです。ドライバーが GDI にビットマップの作成と管理を許可することを選択した場合、戻り値は 0 になります。エラーが発生した場合、戻り値は0xFFFFFFFFされ、GDI はエラーコードをログに記録します。

ドライバーがビットマップを作成する場合は、任意の場所と任意の形式で保存できます。ドライバーはパラメーターの仕様を考慮し、要求されたビット数以上のピクセルを持つビットマップを提供することを前提としています。

作成されたビットマップの内容は未定義です。

この関数は省略可能です。ただし、この関数を実装する場合は、 DrvDeleteDeviceBitmap も実装する必要があります。


対象プラットフォーム	デスクトップ
Header	winddi.h (Winddi.h を含む)