Antarmuka IDXGIOutputDuplication (dxgi1_2.h)

  • Artikel

Antarmuka IDXGIOutputDuplication mengakses dan memanipulasi gambar desktop duplikat.

Warisan

Antarmuka IDXGIOutputDuplication mewarisi dari IDXGIObject. IDXGIOutputDuplication juga memiliki jenis anggota berikut:

Metode

Antarmuka IDXGIOutputDuplication memiliki metode ini.

 
IDXGIOutputDuplication::AcquireNextFrame

Menunjukkan bahwa aplikasi siap untuk memproses gambar desktop berikutnya.
IDXGIOutputDuplication::GetDesc

Mengambil deskripsi output duplikat. Deskripsi ini menentukan dimensi permukaan yang berisi gambar desktop.
IDXGIOutputDuplication::GetFrameDirtyRects

Mendapatkan informasi tentang persegi panjang kotor untuk bingkai desktop saat ini.
IDXGIOutputDuplication::GetFrameMoveRects

Mendapatkan informasi tentang persegi panjang yang dipindahkan untuk bingkai desktop saat ini.
IDXGIOutputDuplication::GetFramePointerShape

Mendapatkan informasi tentang bentuk penunjuk baru untuk bingkai desktop saat ini.
IDXGIOutputDuplication::MapDesktopSurface

Menyediakan akses CPU yang efisien ke gambar desktop jika gambar desktop tersebut sudah ada di memori sistem.
IDXGIOutputDuplication::ReleaseFrame

Menunjukkan bahwa aplikasi selesai memproses bingkai.
IDXGIOutputDuplication::UnMapDesktopSurface

Membatalkan penunjuk ke gambar desktop yang diambil dengan menggunakan IDXGIOutputDuplication::MapDesktopSurface.

Keterangan

Aplikasi kolaborasi dapat menggunakan IDXGIOutputDuplication untuk mengakses gambar desktop. IDXGIOutputDuplication didukung di Desktop Window Manager (DWM) pada mode layar penuh DirectX non-8bpp dan mode layar penuh OpenGL non-8bpp. Mode desktop non-DWM GDI 16-bit atau 32-bit tidak didukung.

Aplikasi dapat menggunakan IDXGIOutputDuplication pada utas terpisah untuk menerima gambar desktop dan untuk memasukkannya ke dalam alur pemrosesan gambar tertentu. Aplikasi ini menggunakan IDXGIOutputDuplication untuk melakukan operasi berikut:

  1. Memperoleh gambar desktop berikutnya.
  2. Ambil informasi yang menjelaskan gambar.
  3. Lakukan operasi pada gambar. Operasi ini bisa sesingkat menyalin gambar ke buffer penahapan sehingga aplikasi dapat membaca data piksel pada gambar. Aplikasi membaca data piksel setelah aplikasi memanggil IDXGISurface::Map. Atau, operasi ini bisa lebih kompleks. Misalnya, aplikasi dapat menjalankan beberapa shader piksel pada wilayah gambar yang diperbarui untuk mengodekan wilayah tersebut untuk transmisi ke klien.
  4. Setelah aplikasi selesai memproses setiap gambar desktop, aplikasi merilis gambar, mengulang ke langkah 1, dan mengulangi langkah-langkahnya. Aplikasi mengulangi langkah-langkah ini sampai selesai memproses gambar desktop.
Komponen sistem operasi berikut dapat menghasilkan gambar desktop:
  • DWM dengan menyusun gambar desktop
  • Aplikasi DirectX atau OpenGL layar penuh
  • Aplikasi dengan beralih ke desktop terpisah, misalnya, desktop aman yang digunakan untuk menampilkan layar masuk
Semua antarmuka IDXGIOutputDuplication saat ini menjadi tidak valid ketika sistem operasi beralih ke komponen berbeda yang menghasilkan gambar desktop atau ketika perubahan mode terjadi. Dalam situasi ini, aplikasi harus menghancurkan antarmuka IDXGIOutputDuplication saat ini dan membuat antarmuka IDXGIOutputDuplication baru.

Contoh situasi di mana IDXGIOutputDuplication menjadi tidak valid adalah:

  • Sakelar desktop
  • Perubahan mode
  • Beralih dari DWM aktif, DWM nonaktif, atau aplikasi layar penuh lainnya
Dalam situasi ini, aplikasi harus merilis antarmuka IDXGIOutputDuplication dan harus membuat antarmuka IDXGIOutputDuplication baru untuk konten baru. Jika aplikasi tidak memiliki hak istimewa yang sesuai untuk gambar desktop baru, panggilannya ke metode IDXGIOutput1::D uplicateOutput gagal.

Sementara aplikasi memproses setiap gambar desktop, sistem operasi mengakumulasi semua pembaruan gambar desktop menjadi satu pembaruan. Untuk informasi selengkapnya tentang pembaruan desktop, lihat Memperbarui data gambar desktop.

Gambar desktop selalu dalam format DXGI_FORMAT_B8G8R8A8_UNORM .

Antarmuka IDXGIOutputDuplication tidak ada untuk aplikasi Windows Store.

Persyaratan

   
Klien minimum yang didukung Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header dxgi1_2.h

Lihat juga

Antarmuka DXGI

IDXGIObject