Platform SDK: DirectX

DirectDrawCreateClipper

DirectDrawCreateClipper 関数は、DirectDraw オブジェクトに関連付けられない DirectDrawClipper オブジェクトのインスタンスを作成する。

HRESULT WINAPI DirectDrawCreateClipper(
  DWORD dwFlags,                           
  LPDIRECTDRAWCLIPPER FAR *lplpDDClipper,  
  IUnknown FAR *pUnkOuter                  
);

パラメータ

dwFlags
現時点では未使用なので 0 を設定しておく。
lplpDDClipper
新しい DirectDrawClipper オブジェクトのアドレスを格納するポインタのアドレス。
pUnkOuter
COM 処理機能との将来的な互換のためにある。ただし、現時点では、このパラメータを NULL に設定しないと、このメソッドはエラーを返す。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

注意

この関数は、あらゆる DirectDraw オブジェクトを作成する前に呼び出すことができる。DirectDraw オブジェクトはこれらの DirectDrawClipper オブジェクトを所有しないので、アプリケーションのオブジェクトが解放されても自動的に解放されることはない。アプリケーションで明示的に DirectDrawClipper オブジェクトを解放しない場合は、アプリケーションの終了時に DirectDraw がそれらのオブジェクトを解放する。

特定の DirectDraw オブジェクトによって所有される DirectDrawClipper オブジェクトを作成するには、IDirectDraw7::CreateClipper メソッドを使用する。

動作環境

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

参照

IDirectDraw7::CreateClipper