Platform SDK: DirectX |
DirectDrawCreateClipper 関数は、DirectDraw オブジェクトに関連付けられない DirectDrawClipper オブジェクトのインスタンスを作成する。
HRESULT WINAPI DirectDrawCreateClipper( DWORD dwFlags, LPDIRECTDRAWCLIPPER FAR *lplpDDClipper, IUnknown FAR *pUnkOuter );
成功すれば、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 を使用。