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 を使用してデバイス固有の形式を送信することもできます。 サポートされている定義済みの形式は次のとおりです。

意味
BMF_1BPP ピクセルあたり 1 ビット。
BMF_4BPP ピクセルあたり 4 ビット。
BMF_8BPP ピクセルあたり 8 ビット。
BMF_16BPP ピクセルあたり 16 ビット。
BMF_24BPP ピクセルあたり 24 ビット。
BMF_32BPP ピクセルあたり 32 ビット。
BMF_4RLE ピクセルあたり 4 ビット、実行長がエンコードされています。
BMF_8RLE ピクセルあたり 8 ビット、実行長がエンコードされています。
BMF_JPEG JPEG 圧縮画像。
BMF_PNG PNG 圧縮イメージ。

iType

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

Type 定義
STYPE_BITMAP サーフェスはビットマップです。
STYPE_DEVBITMAP サーフェスは、デバイス形式のビットマップです。
STYPE_DEVICE サーフェスはデバイスによって管理されます。

fjBitmap

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

意味
BMF_DONTCACHE ビットマップは GDI によって作成された一時的なビットマップであり、ドライバーが再び表示することはないため、ドライバーによってキャッシュされるべきではありません。 このフラグが設定されている場合、この構造体の iUniq メンバーは 0 に設定されます。
BMF_KMSECTION GDI でのみ使用され、ドライバーでは無視する必要があります。
BMF_NOTSYSMEM ビットマップはシステム メモリ内にありません。 EngModifySurface は、 ビットマップをビデオ メモリに移動するときにこのフラグを設定します。
BMF_NOZEROINIT ビットマップが 0 初期化されませんでした。
BMF_TOPDOWN 最初のスキャン行は、ビットマップの 上部 を表します。
BMF_WINDOW_BLT GDI は、ウィンドウが画面の場所から別の場所に移動することをドライバーに通知するために、このフラグを設定します。

注釈

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

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

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

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

要件

   
ヘッダー winddi.h (Winddi.h を含む)