DrvDeriveSurface 関数 (winddi.h)

  • [アーティクル]

DrvDeriveSurface 関数は、指定した DirectDraw サーフェイスから GDI サーフェスを派生させます。

構文

HBITMAP DrvDeriveSurface(
  DD_DIRECTDRAW_GLOBAL *pDirectDraw,
  DD_SURFACE_LOCAL     *pSurface
);

パラメーター

pDirectDraw

DirectDraw オブジェクトを記述する DD_DIRECTDRAW_GLOBAL 構造体へのポインター。

pSurface

GDI サーフェスをラップする DirectDraw サーフェスを記述する DD_SURFACE_LOCAL 構造体へのポインター。

戻り値

DrvDeriveSurface は 、成功した場合に派生 GDI サーフェスへのハンドルを返します。 呼び出しが失敗した場合、またはドライバーが指定された DirectDraw サーフェイスへの GDI 描画を高速化できない場合は 、NULL を 返します。

注釈

DrvDeriveSurface を使用すると、ドライバーは、DirectDraw ビデオ メモリまたは AGP サーフェス オブジェクトの周囲にラップされた GDI サーフェスを作成して、サーフェスへの高速 GDI 描画を可能にします。 ドライバーがこの呼び出しをフックしない場合、DirectDraw サーフェスへのすべての GDI 描画は、DIB エンジンを使用してソフトウェアで行われます。

GDI は、RGB サーフェスのみを使用して DrvDeriveSurface を呼び出します。

ドライバーは DrvCreateDeviceBitmap を呼び出して、DirectDraw サーフェイスと同じサイズと形式の GDI サーフェスを作成する必要があります。 既に存在するため、実際のピクセルの領域を割り当てる必要はありません。

要件

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

こちらもご覧ください

DrvCreateDeviceBitmap

EngCreateDeviceBitmap

EngModifySurface