Platform SDK: DirectX

IDirectDraw7::CreateClipper

IDirectDraw7::CreateClipper メソッドは、DirectDrawClipper オブジェクトを作成する。

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

パラメータ

dwFlags
現時点では未使用なので 0 を設定しておく。
lplpDDClipper
呼び出しが成功した場合に、有効な IDirectDrawClipper インターフェイス ポインタを設定する変数のアドレス。
pUnkOuter
COM 処理機能との将来的な互換のためにある。ただし、現時点では、このパラメータを NULL に設定しないと、このメソッドはエラーを返す。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOCOOPERATIVELEVELSET
DDERR_OUTOFMEMORY

注意

DirectDrawClipper オブジェクトは DirectDrawSurface にアタッチでき、IDirectDrawSurface7::BltIDirectDrawSurface7::BltBatch、および IDirectDrawSurface7::UpdateOverlay の処理中に使用できる。

特定の DirectDraw オブジェクトによって所有されない DirectDrawClipper オブジェクトを作成するには、DirectDrawCreateClipper 関数を使用する。

動作環境

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

参照

IDirectDrawSurface7::GetClipperIDirectDrawSurface7::SetClipper