IDXGIDevice2::Metode ReclaimResources (dxgi1_2.h)
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 |