Metode IDirect3DDevice9Ex::CreateRenderTargetEx (d3d9.h)
Membuat permukaan target render.
Sintaks
HRESULT CreateRenderTargetEx(
[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,
[in] DWORD Usage
);
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.
[in] Usage
Jenis: DWORD
Kombinasi satu atau beberapa konstanta D3DUSAGE yang dapat or'd bersama-sama. Nilai 0 menunjukkan tidak ada penggunaan.
Nilai kembali
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 |
Pustaka | D3D9.lib |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk