Metode IDirect3DDevice9Ex::CreateOffscreenPlainSurfaceEx (d3d9.h)

  • Artikel

Membuat permukaan di luar layar.

Sintaks

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

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**

Penunjuk 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.

[in] Usage

Jenis: DWORD

Kombinasi satu atau beberapa konstanta D3DUSAGE yang dapat or'd bersama-sama. Nilai 0 menunjukkan tidak ada penggunaan.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

D3DPOOL_SCRATCH akan mengembalikan permukaan yang memiliki karakteristik identik dengan 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 d3d9.h
Pustaka D3D9.lib

Lihat juga

IDirect3DDevice9Ex