Platform SDK: DirectX

IDirectDraw7::Initialize

IDirectDraw7::Initialize メソッドは、CoCreateInstance COM 関数を使って作成された DirectDraw オブジェクトを初期化する。

HRESULT Initialize(
  GUID FAR *lpGUID  
);

パラメータ

lpGUID
インターフェイス識別子として使われるグローバル ユニーク識別子 (GUID) のアドレス。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_ALREADYINITIALIZED
DDERR_DIRECTDRAWALREADYCREATED
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NODIRECTDRAWHW
DDERR_NODIRECTDRAWSUPPORT
DDERR_OUTOFMEMORY

このメソッドは、コンポーネント オブジェクト モデル (COM) プロトコル準拠で提供される。DirectDraw オブジェクトを作成するために DirectDrawCreate 関数を使用した場合、このメソッドは DDERR_ALREADYINITIALIZED を返す。DirectDraw オブジェクトを作成するために CoCreateInstance を使用するときに IDirectDraw7::Initialize を呼び出していない場合、後で呼び出されるメソッドは DDERR_NOTINITIALIZED を返す。

注意

CoCreateInstance と共に IDirectDraw7::Initialize を使用することについての詳細情報は、「CoCreateInstance を用いた DirectDraw オブジェクトの作成」を参照すること。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。