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 |
| 程式庫 | Ddraw.lib |
| Dll | Ddraw.dll |