Share via

Metode IDirectDrawSurface7::GetAttachedSurface (ddraw.h)

  • Artikel

Mendapatkan permukaan terlampir yang memiliki kemampuan yang ditentukan, dan menaikkan jumlah referensi antarmuka yang diambil.

Sintaks

HRESULT GetAttachedSurface(
  [in]  LPDDSCAPS2           unnamedParam1,
  [out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);

Parameter

[in] unnamedParam1

Penunjuk ke struktur DDSCAPS2 yang menunjukkan kemampuan perangkat keras permukaan yang terpasang.

[out] unnamedParam2

Pointer ke variabel untuk menerima pointer ke antarmuka IDirectDrawSurface7 permukaan yang diambil. Permukaan yang diambil adalah permukaan yang cocok dengan deskripsi, menurut parameter lpDDSCaps .

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan adalah DD_OK.

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

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOTFOUND
  • DDERR_SURFACELOST

Keterangan

Lampiran digunakan untuk menyambungkan beberapa objek DirectDrawSurface ke dalam struktur kompleks, seperti struktur kompleks yang diperlukan untuk mendukung halaman 3-D membalik dengan z-buffer. GetAttachedSurface gagal jika lebih dari satu permukaan terpasang yang cocok dengan kemampuan yang diminta. Dalam hal ini, aplikasi harus menggunakan metode IDirectDrawSurface7::EnumAttachedSurfaces untuk mendapatkan permukaan yang terpasang.

Persyaratan

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

Lihat juga

IDirectDrawSurface7