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

另請參閱

IDirectDrawSurface7