Metodo IDXGIDevice2::OfferResources (dxgi1_2.h)

Articolo
08/23/2023

Consente al sistema operativo di liberare la memoria video delle risorse rimuovendone il contenuto.

Sintassi

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

Parametri

[in] NumResources

Numero di risorse nella matrice di argomenti ppResources .

[in] ppResources

Matrice di puntatori alle interfacce IDXGIResource per le risorse da offrire.

[in] Priority

Valore tipizzato DXGI_OFFER_RESOURCE_PRIORITY che indica la quantità di dati importanti.

Valore restituito

OfferResources restituisce :

S_OK se le risorse sono state offerte correttamente
E_INVALIDARG se una risorsa nella matrice o la priorità non è valida

Commenti

Il valore di priorità specificato dal parametro Priority descrive il valore che il chiamante considera il contenuto. Il sistema operativo usa il valore di priorità per eliminare le risorse in ordine di priorità. Il sistema operativo elimina una risorsa offerta con priorità bassa prima che elimini una risorsa offerta con priorità più alta.

Se si chiama OfferResources per offrire una risorsa mentre la risorsa è associata alla pipeline, la risorsa non è associata. Non è possibile chiamare OfferResources su una risorsa mappata. Dopo aver offerto una risorsa, la risorsa non può essere mappata o associata alla pipeline finché non si chiama il metodo IDXGIDevice2::ReclaimResource per recuperare la risorsa. Non è possibile chiamare OfferResources per offrire risorse non modificabili.

Per offrire risorse condivise, chiamare OfferResources solo in uno dei dispositivi di condivisione. Per garantire l'accesso esclusivo alle risorse, è necessario usare un oggetto IDXGIKeyedMutex e quindi chiamare OfferResources solo mentre si mantiene il mutex. Infatti, non è possibile offrire risorse condivise a meno che non si usi IDXGIKeyedMutex perché l'offerta di risorse condivise senza l'uso di IDXGIKeyedMutex non è supportata.

Nota Il driver di visualizzazione in modalità utente potrebbe non offrire immediatamente le risorse specificate in una chiamata a OfferResources. Il driver può rimandare l'offerta fino alla chiamata successiva a IDXGISwapChain::P resent, IDXGISwapChain1::P resent1 o ID3D11DeviceContext::Flush.

Aggiornamento della piattaforma per Windows 7: Il runtime verifica che OfferResources venga usato correttamente nelle risorse non condivise, ma non esegue la funzionalità prevista. Per altre info sull'aggiornamento della piattaforma per Windows 7, vedi Platform Update per Windows 7.

Requisiti


Client minimo supportato	Windows 8 e Platform Update per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dxgi1_2.h
Libreria	Dxgi.lib

Vedi anche

IDXGIDevice2

IDXGIDevice2::ReclaimResource

Condividi tramite