IDirectDrawSurface7::SetSurfaceDesc メソッド (ddraw.h)
既存のサーフェスの特性を設定します。
構文
HRESULT SetSurfaceDesc(
[in] LPDDSURFACEDESC2 unnamedParam1,
[in] DWORD unnamedParam2
);
パラメーター
[in] unnamedParam1
新しいサーフェス特性を含む DDSURFACEDESC2 構造体へのポインター。
[in] unnamedParam2
現在は使用されていません。0 に設定する必要があります。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_INVALIDPARAMS
- DDERR_INVALIDOBJECT
- DDERR_SURFACELOST
- DDERR_SURFACEBUSY
- DDERR_INVALIDSURFACETYPE
- DDERR_INVALIDPIXELFORMAT
- DDERR_INVALIDCAPS
- DDERR_UNSUPPORTED
- DDERR_GENERIC
注釈
現時点では、 SetSurfaceDesc のみを使用して、明示的なシステム メモリ サーフェスで使用されるサーフェス データとピクセル形式を設定できます。 これは、コピーせずに以前に割り当てられたバッファーのデータをサーフェスで使用できるため便利です。 新しいサーフェス メモリはクライアント アプリケーションによって割り当てられるため、クライアント アプリケーションも割り当てを解除する必要があります。
DirectDrawSurface オブジェクトは、割り当てなかったサーフェス メモリの割り当てを解除しません。 そのため、サーフェス メモリが不要になった場合は、割り当てを解除する必要があります。 ただし、 SetSurfaceDesc を呼び出すと、DirectDraw は、サーフェスの作成時に暗黙的に割り当てられた元のサーフェス メモリを解放します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |