Metode IDirect3DDevice9::GetFrontBufferData (d3d9helper.h)

  • Artikel

Menghasilkan salinan buffer depan perangkat dan tempat yang menyalin dalam buffer memori sistem yang disediakan oleh aplikasi.

Sintaks

HRESULT GetFrontBufferData(
  [in] UINT              iSwapChain,
  [in] IDirect3DSurface9 *pDestSurface
);

Parameter

[in] iSwapChain

Jenis: UINT

Bilangan bulat yang tidak ditandatangani yang menentukan rantai pertukaran.

[in] pDestSurface

Jenis: IDirect3DSurface9*

Arahkan ke antarmuka IDirect3DSurface9 yang akan menerima salinan konten buffer depan. Data dikembalikan dalam baris berturut-turut tanpa ruang intervensi, mulai dari baris tertinggi secara vertikal pada output perangkat ke terendah.

Untuk mode berjendela, ukuran permukaan tujuan harus ukuran desktop. Untuk mode layar penuh, ukuran permukaan tujuan harus ukuran layar.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL

Keterangan

Buffer yang ditunjukkan oleh pDestSurface akan diisi dengan representasi buffer depan, dikonversi ke format standar 32 bit per piksel D3DFMT_A8R8G8B8.

Metode ini adalah satu-satunya cara untuk menangkap cuplikan layar yang antialisis.

Fungsi ini sangat lambat, berdasarkan desain, dan tidak boleh digunakan di jalur kritis performa apa pun.

Untuk informasi selengkapnya, lihat Perangkat yang Hilang dan Data yang Diambil.

Persyaratan

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

Lihat juga

IDirect3DDevice9