Metode IDirect3DDevice9::CreateOffscreenPlainSurface (d3d9helper.h)

  • Artikel

Membuat permukaan di luar layar.

Sintaks

HRESULT CreateOffscreenPlainSurface(
  [in]          UINT              Width,
  [in]          UINT              Height,
  [in]          D3DFORMAT         Format,
  [in]          D3DPOOL           Pool,
  [out, retval] IDirect3DSurface9 **ppSurface,
  [in]          HANDLE            *pSharedHandle
);

Parameter

[in] Width

Jenis: UINT

Lebar permukaan.

[in] Height

Jenis: UINT

Tinggi permukaan.

[in] Format

Jenis: D3DFORMAT

Format permukaan. Lihat D3DFORMAT.

[in] Pool

Jenis: D3DPOOL

Jenis kumpulan permukaan. Lihat D3DPOOL.

[out, retval] ppSurface

Jenis: IDirect3DSurface9**

Arahkan ke antarmuka IDirect3DSurface9 yang dibuat.

[in] pSharedHandle

Jenis: HANDEL*

Dicadangkan. Atur parameter ini ke NULL. Parameter ini dapat digunakan di Direct3D 9 untuk Windows Vista untuk berbagi sumber daya.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan bisa menjadi berikut: D3DERR_INVALIDCALL.

Keterangan

D3DPOOL_SCRATCH akan mengembalikan permukaan yang memiliki karakteristik identik ke permukaan yang dibuat oleh metode DirectX 8.x CreateImageSurface.

D3DPOOL_DEFAULT adalah kumpulan yang sesuai untuk digunakan dengan IDirect3DDevice9::StretchRect dan IDirect3DDevice9::ColorFill.

D3DPOOL_MANAGED tidak diizinkan saat membuat permukaan biasa di luar layar. Untuk informasi selengkapnya tentang kumpulan memori, lihat D3DPOOL.

Permukaan biasa di luar layar selalu dapat dikunci, terlepas dari jenis kumpulannya.

Persyaratan

   
Target Platform Windows
Header d3d9helper.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

IDirect3DDevice9