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
| 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 |