Platform SDK: DirectX |
IDirectDrawClipper::SetClipList メソッドは、DirectDrawClipper の親オブジェクトをアタッチするサーフェスの IDirectDrawSurface7::Blt、IDirectDrawSurface7::BltBatch、および IDirectDrawSurface7::UpdateOverlay メソッドで使用するクリップ リストを設定または削除する。
HRESULT SetClipList( LPRGNDATA lpClipList, DWORD dwFlags );
成功すれば、DD_OK を返す。
失敗すれば、以下のエラー値のいずれかを返す。
DDERR_CLIPPERISUSINGHWND |
DDERR_INVALIDCLIPLIST |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_OUTOFMEMORY |
ウィンドウ ハンドルが既に DirectDrawClipper オブジェクトに関連付けられている場合、クリップ リストは設定されない。BltFast メソッドではクリップできない。
このメソッドで使用される RGNDATA 構造体は、次に示す構文となる。
typedef struct _RGNDATA { RGNDATAHEADER rdh; char Buffer[1]; } RGNDATA;
RGNDATA 構造体の rdh メンバは、次の構文の RGNDATAHEADER 構造体である。
typedef struct _RGNDATAHEADER { DWORD dwSize; DWORD iType; DWORD nCount; DWORD nRgnSize; RECT rcBound; } RGNDATAHEADER;
これらの構造体の詳細については、プラットフォーム SDK を参照すること。
Windows NT/2000 : Windows NT 4.0 Service Pack 3 またはそれ以降が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : ddraw.h で宣言。
インポート ライブラリ : ddraw.lib を使用。
IDirectDrawClipper::GetClipList、IDirectDrawSurface7::Blt、IDirectDrawSurface7::BltFast、IDirectDrawSurface7::BltBatch、IDirectDrawSurface7::UpdateOverlay