Share via

Metode IDirectDrawSurface7::SetSurfaceDesc (ddraw.h)

  • Artikel

Mengatur karakteristik permukaan yang ada.

Sintaks

HRESULT SetSurfaceDesc(
  [in] LPDDSURFACEDESC2 unnamedParam1,
  [in] DWORD            unnamedParam2
);

Parameter

[in] unnamedParam1

Penunjuk ke struktur DDSURFACEDESC2 yang berisi karakteristik permukaan baru.

[in] unnamedParam2

Saat ini tidak digunakan dan harus diatur ke 0.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan DD_OK.

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

  • DDERR_INVALIDPARAMS
  • DDERR_INVALIDOBJECT
  • DDERR_SURFACELOST
  • DDERR_SURFACEBUSY
  • DDERR_INVALIDSURFACETYPE
  • DDERR_INVALIDPIXELFORMAT
  • DDERR_INVALIDCAPS
  • DDERR_UNSUPPORTED
  • DDERR_GENERIC

Keterangan

Saat ini, Anda dapat menggunakan SetSurfaceDesc hanya untuk mengatur data permukaan dan format piksel yang digunakan oleh permukaan memori sistem eksplisit. Ini berguna karena memungkinkan permukaan untuk menggunakan data dari buffer yang dialokasikan sebelumnya tanpa menyalin. Memori permukaan baru dialokasikan oleh aplikasi klien, dan oleh karena itu aplikasi klien juga harus membatalkan alokasinya.

Objek DirectDrawSurface tidak membatalkan alokasi memori permukaan yang tidak dialokasikan. Oleh karena itu, ketika memori permukaan tidak lagi diperlukan, Anda harus membatalkan alokasinya. Namun, ketika Anda memanggil SetSurfaceDesc, DirectDraw membebaskan memori permukaan asli yang dialokasikan secara implisit saat membuat permukaan.

Persyaratan

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

Lihat juga

IDirectDrawSurface7