SURFOBJ 構造体 (winddi.h)

SURFOBJ 構造体は、サーフェスのユーザー オブジェクトです。 通常、デバイス ドライバーは、サーフェス オブジェクトが GDI ビットマップまたは デバイス管理サーフェスを表す場合にのみ、サーフェス オブジェクトのメソッドを呼び出します。

構文

typedef struct _SURFOBJ {
  DHSURF dhsurf;
  HSURF  hsurf;
  DHPDEV private_dhpdev;
  HDEV   private_hdev;
  DHPDEV dhpdev;
  HDEV   hdev;
  SIZEL  sizlBitmap;
  ULONG  cjBits;
  PVOID  pvBits;
  PVOID  pvScan0;
  LONG   lDelta;
  ULONG  iUniq;
  ULONG  iBitmapFormat;
  USHORT iType;
  USHORT fjBitmap;
} SURFOBJ;

メンバー

dhsurf

サーフェスがデバイスで管理されている場合は、サーフェスにハンドルします。 それ以外の場合、このメンバーは 0 です。

hsurf

サーフェスへのハンドル。

private_dhpdev

private_hdev

dhpdev

指定したサーフェスに関連付けられているデバイスの PDEV を識別します。

hdev

このデバイスに関連付けられている PDEV に対する GDI の論理ハンドル。

sizlBitmap

サーフェスの幅と高さをピクセル単位で格納する SIZEL 構造体を指定します。 SIZEL 構造体は SIZE 構造体と 同じです。

cjBits

pvBits によって指されるバッファーのサイズを指定します。

pvBits

サーフェスが標準形式のビットマップの場合、これはサーフェスのピクセルへのポインターです。 BMF_JPEGまたはBMF_PNGイメージの場合、これは JPEG または PNG 形式の画像データを含むバッファーへのポインターです。 それ以外の場合、このメンバーは NULL です。

pvScan0

ビットマップの最初のスキャン行へのポインター。 iBitmapFormat がBMF_JPEGまたはBMF_PNGの場合、このメンバーは NULL です。

lDelta

ビットマップ内のスキャン行を 1 つ下に移動するために必要なバイト数を指定します。 iBitmapFormat がBMF_JPEGまたはBMF_PNGの場合、このメンバーは NULL です。

iUniq

指定したサーフェスの現在の状態を指定します。 サーフェスが変更されるたびに、この値がインクリメントされます。 これにより、ドライバーはソース サーフェスをキャッシュできます。

キャッシュしないサーフェスの場合、 iUniq は 0 に設定されます。 この値は、 fjBitmap の BMF_DONTCACHE フラグと組み合わせて使用されます。

iBitmapFormat

このサーフェスに最も近い標準書式を指定します。 iType メンバーがビットマップ (STYPE_BITMAP) を指定する場合、このメンバーはその形式を指定します。 NT ベースのオペレーティング システムでは一連の定義済み形式がサポートされていますが、アプリケーションでは SetDIBitsToDevice を使用してデバイス固有の形式を送信することもできます。 サポートされている定義済みの形式は次のとおりです。

iType

サーフェスの種類。これは次のいずれかです。

fjBitmap

サーフェスが STYPE_BITMAP 型で、標準の非圧縮形式のビットマップである場合は、次のフラグを設定できます。 それ以外の場合、このメンバーは無視する必要があります。

注釈

ドライバーによって特定のサーフェスに関する情報が必要な場合、ドライバーは SURFOBJ にアクセスする必要があります。 この構造により、サーフェスのプロパティにすばやくアクセスできます。

SURFOBJ 構造体が GDI ビットマップを表す場合、ドライバーはビットマップの形式を決定し、ビットマップ ビットを検索できる必要があります。

SURFOBJ 構造体がデバイス サーフェイスを表す場合、ドライバーはサーフェスのデバイス ハンドルを見つけることができるようにする必要があります。

JPEG および PNG 圧縮イメージのサポートの詳細については、「 DEVINFO」を参照してください。

要件