Platform SDK: DirectX

Direct3D7.CreateDevice

Direct3D7.CreateDevice メソッドは、DrawPrimitive メソッドで使用するために、Direct3D デバイスを生成する。

object.CreateDevice( _ 
    guid As String, _ 
    surf As DirectDrawSurface7) As Direct3DDevice7

パラメータ

object
Direct3D7 オブジェクトを表すオブジェクト式。
guid
新規デバイスの GUID。この値は、列挙された GUID 文字列、"IID_Direct3DHALDevice" または "IID_Direct3DRGBDevice" 文字列定数にすることができる。このメソッドは、テストまたは機能デモンストレーション用の基準デバイスを作成する "IID_Direct3DRefDevice" も受け取る。
surf
デバイスのレンダリング ターゲットとなる DirectDrawSurface オブジェクト用の DirectDrawSurface7 オブジェクト。DDSCAPS_3DDEVICE 能力を用いてサーフェスは 3D デバイスとして生成された。

戻り値

メソッドが成功すると、Direct3DDevice7 オブジェクトへの参照を返す。

エラー コード

メソッドが失敗するとエラーが発生し、パラメータのいずれかが無効の場合は、Err.NumberDDERR_INVALIDPARAMS が設定される。

注意

指定された Direct3D7 オブジェクトによって作成されたレンダリング デバイスはすべて、同じ物理リソースを共有する。複数のレンダリング デバイスで同じハードウェアを共有するので、単一の Direct3D7 オブジェクトから複数のレンダリング デバイスを作成できるが、パフォーマンスが大幅に低下する。

Direct3D7.CreateDevice を呼び出すと、DirectDraw サーフェス オブジェクトとは別個のデバイス オブジェクトを作成できる。このデバイスは、DirectDraw サーフェスをレンダリング ターゲットとして使用する。

参照

Direct3DDevice7Direct3D デバイスの作成Direct3D デバイス