Share via

METODE IDXGIOutput1::GetDisplaySurfaceData1 (dxgi1_2.h)

  • Artikel

Menyalin permukaan tampilan (buffer depan) ke sumber daya yang disediakan pengguna.

Sintaks

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

Parameter

[in] pDestination

Penunjuk ke antarmuka sumber daya yang mewakili sumber daya tempat GetDisplaySurfaceData1 menyalin permukaan tampilan.

Nilai kembali

Mengembalikan salah satu kode kesalahan yang dijelaskan dalam topik DXGI_ERROR .

Keterangan

GetDisplaySurfaceData1 mirip dengan IDXGIOutput::GetDisplaySurfaceData kecuali GetDisplaySurfaceData1 mengambil IDXGIResource dan IDXGIOutput::GetDisplaySurfaceData mengambil IDXGISurface.

GetDisplaySurfaceData1 mengembalikan kesalahan jika sumber daya input bukan tekstur 2D (diwakili oleh antarmuka ID3D11Texture2D ) dengan ukuran array (anggota ArraySize dari struktur D3D11_TEXTURE2D_DESC ) yang sama dengan buffer rantai pertukaran.

IDXGIOutput::GetDisplaySurfaceData asli dan GetDisplaySurfaceData1 yang diperbarui berperilaku sama persis. GetDisplaySurfaceData1 diperlukan karena tekstur dengan ukuran array sama dengan 2 (ArraySize = 2) tidak mengimplementasikan IDXGISurface.

Anda dapat memanggil GetDisplaySurfaceData1 hanya ketika output berada dalam mode layar penuh. Jika GetDisplaySurfaceData1 berhasil, getDisplaySurfaceData1 akan mengisi sumber daya tujuan.

Gunakan IDXGIOutput::GetDesc untuk menentukan ukuran (lebar dan tinggi) output saat Anda ingin mengalokasikan ruang untuk sumber daya tujuan. Ini berlaku terlepas dari rotasi monitor target. Sumber daya tujuan yang dibuat oleh komponen grafis (seperti Direct3D 11) harus dibuat dengan izin tulis CPU (lihat D3D11_CPU_ACCESS_WRITE). Permukaan lain dapat dibuat dengan izin baca-tulis CPU (D3D11_CPU_ACCESS_READ | D3D11_CPU_ACCESS_WRITE). GetDisplaySurfaceData1 memodifikasi data permukaan agar sesuai dengan sumber daya tujuan (stretch, shrink, convert format, rotate). GetDisplaySurfaceData1 melakukan peregangan dan menyusut dengan pengambilan sampel titik.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 dan Platform Update untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header dxgi1_2.h
Pustaka DXGI.lib

Lihat juga

IDXGIOutput1