Bagikan melalui

IDirectDrawSurface7::Metode pemulihan (ddraw.h)

  • Artikel

Memulihkan permukaan yang telah hilang. Ini terjadi ketika memori permukaan yang terkait dengan objek DirectDrawSurface telah dibebaskan.

Sintaks

HRESULT Restore();

Mengembalikan nilai

Jika metode berhasil, nilai yang dikembalikan DD_OK.

Jika gagal, metode dapat mengembalikan salah satu nilai kesalahan berikut:

  • DDERR_GENERIC
  • DDERR_IMPLICITLYCREATED
  • DDERR_INCOMPATIBLEPRIMARY
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOEXCLUSIVEMODE
  • DDERR_OUTOFMEMORY
  • DDERR_UNSUPPORTED
  • DDERR_WRONGMODE

Keterangan

Pemulihan memulihkan memori yang dialokasikan untuk permukaan, tetapi tidak memuat ulang bitmap apa pun yang mungkin ada di permukaan sebelum hilang.

Permukaan dapat hilang karena mode adaptor grafis diubah atau karena aplikasi menerima akses eksklusif ke adaptor grafis dan membebaskan semua memori permukaan yang saat ini dialokasikan pada adaptor. Ketika objek DirectDrawSurface kehilangan memori permukaannya, banyak metode mengembalikan DDERR_SURFACELOST dan tidak melakukan fungsi lain. Metode IDirectDrawSurface7::Restore mengalokasikan kembali memori permukaan dan memasangnya kembali ke objek DirectDrawSurface.

Satu panggilan ke Pemulihan memulihkan permukaan implisit terkait objek DirectDrawSurface (buffer belakang, dan sebagainya). Upaya untuk memulihkan permukaan yang dibuat secara implisit menghasilkan kesalahan. Pemulihan tidak berfungsi di seluruh lampiran eksplisit yang dibuat dengan menggunakan metode IDirectDrawSurface7::AddAttachedSurface —masing-masing permukaan ini harus dipulihkan satu per satu.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header ddraw.h
Pustaka Ddraw.lib
DLL Ddraw.dll

Lihat juga

IDirectDrawSurface7