IDXGIDevice2::Metode ReclaimResources (dxgi1_2.h)

  • Artikel

Memulihkan akses ke sumber daya yang sebelumnya ditawarkan dengan memanggil IDXGIDevice2::OfferResources.

Sintaks

HRESULT ReclaimResources(
  [in]            UINT          NumResources,
  [in]            IDXGIResource * const *ppResources,
  [out, optional] BOOL          *pDiscarded
);

Parameter

[in] NumResources

Jumlah sumber daya dalam argumen ppResources dan array argumen pDiscarded .

[in] ppResources

Array pointer ke antarmuka IDXGIResource agar sumber daya dapat diklaim kembali.

[out, optional] pDiscarded

Penunjuk ke array yang menerima nilai Boolean. Setiap nilai dalam array sesuai dengan sumber daya pada indeks yang sama dengan yang ditentukan parameter ppResources . Runtime menetapkan setiap nilai Boolean ke TRUE jika konten sumber daya yang sesuai dibuang dan sekarang tidak terdefinisi, atau ke FALSE jika konten lama sumber daya yang sesuai masih utuh. Penelepon dapat meneruskan NULL, jika pemanggil berniat untuk mengisi sumber daya dengan konten baru terlepas dari apakah konten lama dibuang.

Menampilkan nilai

ReclaimResources mengembalikan:

  • S_OK jika sumber daya berhasil diklaim kembali
  • E_INVALIDARG jika sumber daya tidak valid

Keterangan

Setelah Memanggil IDXGIDevice2::OfferResources untuk menawarkan satu atau beberapa sumber daya, Anda harus memanggil ReclaimResources sebelum dapat menggunakan sumber daya tersebut lagi. Anda harus memeriksa nilai dalam array di pDiscarded untuk menentukan apakah setiap konten sumber daya dibuang. Jika konten sumber daya dibuang saat ditawarkan, kontennya saat ini tidak terdefinisi. Oleh karena itu, Anda harus menimpa konten sumber daya sebelum menggunakan sumber daya.

Untuk mengklaim kembali sumber daya bersama, panggil ReclaimResources hanya di salah satu perangkat berbagi. Untuk memastikan akses eksklusif ke sumber daya, Anda harus menggunakan objek IDXGIKeyedMutex lalu memanggil ReclaimResources hanya saat Anda menahan mutex.

Pembaruan Platform untuk Windows 7: Runtime memvalidasi bahwa ReclaimResources digunakan dengan benar pada sumber daya yang tidak dibagikan tetapi tidak melakukan fungsionalitas yang dimaksudkan. Untuk informasi selengkapnya tentang Pembaruan Platform untuk Windows 7, lihat Pembaruan Platform untuk Windows 7.

Persyaratan

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

Lihat juga

IDXGIDevice2

IDXGIDevice2::OfferResources