Platform SDK: DirectX

DirectDraw7.CreateSurfaceFromResource

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

object.CreateSurfaceFromResource( _ 
    file As String, _ 
    resName As String, _ 
    ddsd As DDSURFACEDESC2) As DirectDrawSurface7

パラメータ

object
DirectDraw7 オブジェクトを表すオブジェクト式。
file
作成するサーフェスにロードするリソースのファイル名。リソースが実行可能ファイルに含まれる場合、リソースの場所を示すには、このパラメータに空の文字列を指定する。このパラメータは、リソースが存在する OCX の名前にすることもできる。
resName
作成するサーフェスにロードするリソースの名前。
ddsd
要求されたサーフェスを記述する 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

注意

モジュール名に空の文字列を使用して Microsoft® Visual Basic® 環境でアプリケーションを実行すると、リソースの場所を検索できない。スタンドアロンの実行可能ファイルを使用している場合のみ、空の文字列を渡しても成功する。

リソース名は、数字ではなく文字で指定しなければならない。リソース名をクオーテーション マークで囲んで文字列にしないと、メソッドは失敗する。