Platform SDK: DirectX

DirectDraw7.CreateSurfaceFromFile

DirectDraw7.CreateSurfaceFromFile メソッドは、この DirectDraw オブジェクトに対する DirectDrawSurface7 オブジェクトを作成し、指定されたビットマップ イメージを DirectDrawSurface オブジェクトにアタッチする。

object.CreateSurfaceFromFile( _ 
    file As String, _ 
    dd As DDSURFACEDESC2) As DirectDrawSurface7

パラメータ

object
DirectDraw7 オブジェクトを表すオブジェクト式。
file
作成するサーフェスにロードするビットマップ イメージの名前。
dd
要求されるサーフェスを記述する DDSURFACEDESC2 型。DDSCAPS2 型は、DDSURFACEDESC2 のメンバである。

戻り値

成功すれば、DirectDrawSurface7 オブジェクトを返す。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_INCOMPATIBLEPRIMARY
DDERR_INVALIDCAPS
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDPIXELFORMAT
DDERR_NOALPHAHW
DDERR_NOCOOPERATIVELEVELSET
DDERR_NODIRECTDRAWHW
DDERR_NOEMULATION
DDERR_NOEXCLUSIVEMODE
DDERR_NOFLIPHW
DDERR_NOMIPMAPHW
DDERR_NOOVERLAYHW
DDERR_NOZBUFFERHW
DDERR_OUTOFMEMORY
DDERR_OUTOFVIDEOMEMORY
DDERR_PRIMARYSURFACEALREADYEXISTS
DDERR_UNSUPPORTEDMODE

注意

256 色を使用する場合、このメソッドを呼び出してパレット情報を表示する前に、ディスプレイ モードとパレットを設定する。