Platform SDK: DirectX

IDirectDrawClipper::Initialize

IDirectDrawClipper::Initialize メソッドは、CoCreateInstance COM 関数を使用して作成した DirectDrawClipper オブジェクトを初期化する。

HRESULT Initialize(
  LPDIRECTDRAW lpDD,  
  DWORD dwFlags       
);

パラメータ

lpDD
DirectDraw オブジェクトを表す DirectDraw 構造体のアドレス。パラメータを NULL に設定すると、独立した DirectDrawClipper オブジェクトが作成される (DirectDrawCreateClipper 関数を使用する場合と同様)。
dwFlags
現時点では未使用なので 0 を設定しておく。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_ALREADYINITIALIZED
DDERR_INVALIDPARAMS

このメソッドは、コンポーネント オブジェクト モデル (COM) プロトコル準拠で提供される。DirectDrawCreateClipper または IDirectDraw7::CreateClipper メソッドを DirectDrawClipper オブジェクトの作成に使用した場合、このメソッドは DDERR_ALREADYINITIALIZED を返す。

注意

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

動作環境

  Windows NT/2000 : Windows NT 4.0 Service Pack 3 またはそれ以降が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : ddraw.h で宣言。
  インポート ライブラリ : ddraw.lib を使用。

参照

IUnknown::AddRefIUnknown::QueryInterfaceIUnknown::ReleaseIDirectDraw7::CreateClipper