IDXGIDevice2::Metode OfferResources (dxgi1_2.h)

Artikel
08/23/2023

Memungkinkan sistem operasi untuk membebaskan memori video sumber daya dengan membuang kontennya.

Sintaks

HRESULT OfferResources(
  [in] UINT                         NumResources,
  [in] IDXGIResource                * const *ppResources,
  [in] DXGI_OFFER_RESOURCE_PRIORITY Priority
);

Parameter

[in] NumResources

Jumlah sumber daya dalam array argumen ppResources .

[in] ppResources

Array pointer ke antarmuka IDXGIResource untuk ditawarkan sumber daya.

[in] Priority

Nilai jenis DXGI_OFFER_RESOURCE_PRIORITY yang menunjukkan seberapa berharga data.

Menampilkan nilai

OfferResources mengembalikan:

S_OK jika sumber daya berhasil ditawarkan
E_INVALIDARG jika sumber daya dalam array atau prioritas tidak valid

Keterangan

Nilai prioritas yang ditentukan parameter Prioritas menjelaskan seberapa berharga pemanggil mempertimbangkan konten. Sistem operasi menggunakan nilai prioritas untuk membuang sumber daya dalam urutan prioritas. Sistem operasi membuang sumber daya yang ditawarkan dengan prioritas rendah sebelum membuang sumber daya yang ditawarkan dengan prioritas lebih tinggi.

Jika Anda memanggil OfferResources untuk menawarkan sumber daya saat sumber daya terikat ke alur, sumber daya tidak terikat. Anda tidak dapat memanggil OfferResources pada sumber daya yang dipetakan. Setelah Anda menawarkan sumber daya, sumber daya tidak dapat dipetakan atau terikat ke alur hingga Anda memanggil metode IDXGIDevice2::ReclaimResource untuk mengklaim kembali sumber daya. Anda tidak dapat memanggil OfferResources untuk menawarkan sumber daya yang tidak dapat diubah.

Untuk menawarkan sumber daya bersama, panggil OfferResources hanya di salah satu perangkat berbagi. Untuk memastikan akses eksklusif ke sumber daya, Anda harus menggunakan objek IDXGIKeyedMutex lalu memanggil OfferResources hanya saat Anda menahan mutex. Bahkan, Anda tidak dapat menawarkan sumber daya bersama kecuali Anda menggunakan IDXGIKeyedMutex karena menawarkan sumber daya bersama tanpa menggunakan IDXGIKeyedMutex tidak didukung.

Catatan Driver tampilan mode pengguna mungkin tidak segera menawarkan sumber daya yang Anda tentukan dalam panggilan ke OfferResources. Driver dapat menunda penawaran mereka sampai panggilan berikutnya ke IDXGISwapChain::P resent, IDXGISwapChain1::P resent1, atau ID3D11DeviceContext::Flush.

Pembaruan Platform untuk Windows 7: Runtime memvalidasi bahwa OfferResources 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 Platform Update untuk Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	dxgi1_2.h
Pustaka	Dxgi.lib

Lihat juga

IDXGIDevice2

IDXGIDevice2::ReclaimResource

Bagikan melalui