IDirectDrawSurface7::Restore 方法 (ddraw.h)
還原已遺失的介面。 當已釋放與 DirectDrawSurface 對象相關聯的表面記憶體時,就會發生這種情況。
Syntax
HRESULT Restore();
傳回值
如果方法成功,傳回值會DD_OK。
如果失敗,方法可以傳回下列其中一個錯誤值:
- DDERR_GENERIC
- DDERR_IMPLICITLYCREATED
- DDERR_INCOMPATIBLEPRIMARY
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOEXCLUSIVEMODE
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
- DDERR_WRONGMODE
備註
還原 會還原配置給表面的記憶體,但不會重載在遺失之前可能存在於介面中的任何點陣圖。
因為圖形配接器的模式已變更,或應用程式收到圖形適配卡的獨佔存取權,並釋放目前配置在配接器上的所有表面記憶體,所以可能會遺失表面。 當 DirectDrawSurface 物件失去其表面記憶體時,許多方法都會傳回DDERR_SURFACELOST並執行任何其他函式。 IDirectDrawSurface7::Restore 方法會重新配置表面記憶體,並將其重新附加至 DirectDrawSurface 物件。
還原的單一呼叫會還原 DirectDrawSurface 對象的關聯隱含表面 (後端緩衝區,依此類) 。 嘗試還原隱含建立的介面會導致錯誤。 還原 不適用於使用 IDirectDrawSurface7::AddAttachedSurface 方法所建立的明確附件,每個介面都必須個別還原。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | ddraw.h |
程式庫 | Ddraw.lib |
Dll | Ddraw.dll |