METODE IDXGIOutputDuplication::ReleaseFrame (dxgi1_2.h)

  • Artikel

Menunjukkan bahwa aplikasi selesai memproses bingkai.

Sintaks

HRESULT ReleaseFrame();

Mengembalikan nilai

ReleaseFrame mengembalikan:

  • S_OK jika berhasil diselesaikan.
  • DXGI_ERROR_INVALID_CALL jika aplikasi sudah merilis bingkai.
  • DXGI_ERROR_ACCESS_LOST jika antarmuka duplikasi desktop tidak valid. Antarmuka duplikasi desktop biasanya menjadi tidak valid ketika jenis gambar yang berbeda ditampilkan di desktop. Contoh situasi ini 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 membuat IDXGIOutputDuplication baru untuk konten baru.
  • Mungkin kode kesalahan lain yang dijelaskan dalam topik DXGI_ERROR .

Keterangan

Aplikasi harus merilis bingkai sebelum memperoleh bingkai berikutnya. Setelah bingkai dilepaskan, permukaan yang berisi bitmap desktop menjadi tidak valid; Anda tidak akan dapat menggunakan permukaan dalam operasi grafik DirectX.

Untuk alasan performa, kami sarankan Anda merilis bingkai tepat sebelum Anda memanggil metode IDXGIOutputDuplication::AcquireNextFrame untuk memperoleh bingkai berikutnya. Ketika klien tidak memiliki bingkai, sistem operasi menyalin semua pembaruan desktop ke permukaan. Ini dapat mengakibatkan siklus GPU yang terbuang jika sistem operasi memperbarui wilayah yang sama untuk setiap bingkai yang terjadi. Ketika klien memperoleh bingkai, klien hanya mengetahui pembaruan akhir ke wilayah ini; oleh karena itu, setiap pembaruan yang tumpang tindih selama bingkai sebelumnya terbuang sia-sia. Ketika klien memperoleh bingkai, klien memiliki permukaan; oleh karena itu, sistem operasi hanya dapat melacak wilayah yang diperbarui dan tidak dapat menyalin pembaruan desktop ke permukaan. Karena perilaku ini, kami sarankan Anda meminimalkan waktu antara panggilan untuk merilis bingkai saat ini dan panggilan untuk memperoleh bingkai berikutnya.

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
Pustaka Dxgi.lib

Lihat juga

IDXGIOutputDuplication