Metodo IDXGIDevice2::ReclaimResources (dxgi1_2.h)

Ripristina l'accesso alle risorse offerte in precedenza chiamando IDXGIDevice2::OfferResources.

Sintassi

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

Parametri

[in] NumResources

Numero di risorse nell'argomento ppResources e nelle matrici di argomenti pDiscarded .

[in] ppResources

Matrice di puntatori alle interfacce IDXGIResource per recuperare le risorse.

[out, optional] pDiscarded

Puntatore a una matrice che riceve valori booleani. Ogni valore della matrice corrisponde a una risorsa allo stesso indice specificato dal parametro ppResources . Il runtime imposta ogni valore booleano su TRUE se il contenuto della risorsa corrispondente è stato rimosso e ora non è definito o su FALSE se il contenuto precedente della risorsa corrispondente è ancora intatto. Il chiamante può passare NULL, se il chiamante intende riempire le risorse con nuovo contenuto indipendentemente dal fatto che il contenuto precedente sia stato rimosso.

Valore restituito

RecuperaResources restituisce :

• S_OK se le risorse sono state recuperate correttamente
• E_INVALIDARG se le risorse non sono valide

Commenti

Dopo aver chiamato IDXGIDevice2::OfferResources per offrire una o più risorse, è necessario chiamare ReclaimResources prima di poter usare di nuovo queste risorse. È necessario controllare i valori nella matrice in pDiscarded per determinare se il contenuto di ogni risorsa è stato rimosso. Se il contenuto di una risorsa è stato rimosso mentre è stato offerto, il relativo contenuto corrente non è definito. È pertanto necessario sovrascrivere il contenuto della risorsa prima di usare la risorsa.

Per recuperare le risorse condivise, chiamare RecuperaResources solo in uno dei dispositivi di condivisione. Per garantire l'accesso esclusivo alle risorse, è necessario usare un oggetto IDXGIKeyedMutex e quindi chiamare RecuperaResources solo mentre si mantiene il mutex.

Aggiornamento della piattaforma per Windows 7: Il runtime convalida che RecuperaResources viene usato correttamente nelle risorse non condivise, ma non esegue la funzionalità prevista. Per altre informazioni sull'aggiornamento della piattaforma per Windows 7, vedere Platform Update per Windows 7.

Requisiti

Vedi anche

IDXGIDevice2

IDXGIDevice2::OfferResources