IDirectDrawClipper::SetClipList メソッド (ddraw.h)
親 DirectDrawClipper オブジェクトがアタッチされているサーフェスの IDirectDrawSurface7::Blt、 IDirectDrawSurface7::BltBatch、 および IDirectDrawSurface7::UpdateOverlay メソッドで使用されるクリップ リストを設定または削除します。
構文
HRESULT SetClipList(
[in] LPRGNDATA unnamedParam1,
[in] DWORD unnamedParam2
);
パラメーター
[in] unnamedParam1
設定するクリップ リストまたは NULL の有効な RGNDATA 構造体へのポインター。 DirectDrawClipper オブジェクトに関連付けられている既存のクリップ リストがあり、この値が NULL の場合、クリップ リストは削除されます。
[in] unnamedParam2
現在は使用されておらず、0 に設定する必要があります。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_CLIPPERISUSINGHWND
- DDERR_INVALIDCLIPLIST
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
解説
ウィンドウ ハンドルが DirectDrawClipper オブジェクトに既に関連付けられている場合は、クリップ リストを設定できません。
IDirectDrawSurface7::BltFast メソッドはクリップできません。 クリップパーがアタッチされたサーフェスで IDirectDrawSurface7::BltFast を呼び出すと、DDERR_UNSUPPORTEDが返されます。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |