Metode IDirect3DDevice9::CreateRenderTarget (d3d9.h)

Artikel
02/29/2024

Membuat permukaan target render.

Sintaks

HRESULT CreateRenderTarget(
  [in]          UINT                Width,
  [in]          UINT                Height,
  [in]          D3DFORMAT           Format,
  [in]          D3DMULTISAMPLE_TYPE MultiSample,
  [in]          DWORD               MultisampleQuality,
  [in]          BOOL                Lockable,
  [out, retval] IDirect3DSurface9   **ppSurface,
  [in]          HANDLE              *pSharedHandle
);

Parameter

[in] Width

Jenis: UINT

Lebar permukaan target render, dalam piksel.

[in] Height

Jenis: UINT

Tinggi permukaan render-target, dalam piksel.

[in] Format

Jenis: D3DFORMAT

Anggota jenis D3DFORMAT yang dijumlahkan, menjelaskan format target render.

[in] MultiSample

Jenis: D3DMULTISAMPLE_TYPE

Anggota jenis D3DMULTISAMPLE_TYPE yang dijumlahkan, yang menjelaskan jenis buffer multisampling. Parameter ini menentukan jenis antialias untuk target render ini. Ketika permukaan ini diteruskan ke IDirect3DDevice9::SetRenderTarget, jenis multisample-nya harus sama dengan stensil kedalaman yang diatur oleh IDirect3DDevice9::SetDepthStencilSurface.

[in] MultisampleQuality

Jenis: DWORD

Tingkat kualitas. Rentang yang valid adalah antara nol dan satu kurang dari tingkat yang dikembalikan oleh pQualityLevels yang digunakan oleh IDirect3D9::CheckDeviceMultiSampleType. Meneruskan nilai yang lebih besar mengembalikan kesalahan, D3DERR_INVALIDCALL. Nilai MultisampleQuality dari target render berpasangan, permukaan stensil kedalaman, dan jenis multisample semuanya harus cocok.

[in] Lockable

Jenis: BOOL

Target render tidak dapat dikunci kecuali aplikasi menentukan TRUE untuk Dapat Dikunci.

Perhatikan bahwa target render yang dapat dikunci mengurangi performa pada beberapa perangkat keras grafis. Performa readback (memindahkan data dari memori video ke memori sistem) tergantung pada jenis perangkat keras yang digunakan (AGP vs. PCI Express) dan biasanya jauh lebih rendah daripada performa unggahan (memindahkan data dari sistem ke memori video). Jika Anda memerlukan akses baca untuk merender target, gunakan GetRenderTargetData alih-alih target render yang dapat dikunci.

[out, retval] ppSurface

Jenis: IDirect3DSurface9**

Alamat penunjuk ke antarmuka IDirect3DSurface9 .

[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 adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan bisa menjadi salah satu dari yang berikut: D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Keterangan

Permukaan target render ditempatkan di kelas memori D3DPOOL_DEFAULT.

Pembuatan target render multisampled yang dapat dikunci tidak didukung.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d3d9.h (termasuk D3D9.h)
Pustaka	D3D9.lib

Lihat juga

IDirect3DDevice9

Bagikan melalui