Método IDXGIDevice2::ReclaimResources (dxgi1_2.h)
Restaura o acesso aos recursos que foram oferecidos anteriormente chamando IDXGIDevice2::OfferResources.
Sintaxe
HRESULT ReclaimResources(
[in] UINT NumResources,
[in] IDXGIResource * const *ppResources,
[out, optional] BOOL *pDiscarded
);
Parâmetros
[in] NumResources
O número de recursos nas matrizes de argumento ppResources e pDiscarded .
[in] ppResources
Uma matriz de ponteiros para interfaces IDXGIResource para os recursos a serem recuperados.
[out, optional] pDiscarded
Um ponteiro para uma matriz que recebe valores boolianos. Cada valor na matriz corresponde a um recurso no mesmo índice especificado pelo parâmetro ppResources . O runtime define cada valor booliano como TRUE se o conteúdo do recurso correspondente foi descartado e agora está indefinido ou como FALSE se o conteúdo antigo do recurso correspondente ainda estiver intacto. O chamador poderá passar NULL se o chamador pretende preencher os recursos com novo conteúdo, independentemente de o conteúdo antigo ter sido descartado.
Valor retornado
ReclaimResources retorna:
- S_OK se os recursos foram recuperados com êxito
- E_INVALIDARG se os recursos forem inválidos
Comentários
Depois de chamar IDXGIDevice2::OfferResources para oferecer um ou mais recursos, você deve chamar ReclaimResources antes de poder usar esses recursos novamente. Você deve marcar os valores na matriz em pDiscarded para determinar se o conteúdo de cada recurso foi descartado. Se o conteúdo de um recurso tiver sido descartado enquanto ele foi oferecido, seu conteúdo atual será indefinido. Portanto, você deve substituir o conteúdo do recurso antes de usar o recurso.
Para recuperar recursos compartilhados, chame ReclaimResources apenas em um dos dispositivos de compartilhamento. Para garantir o acesso exclusivo aos recursos, você deve usar um objeto IDXGIKeyedMutex e chamar ReclaimResources somente enquanto mantém o mutex.
Atualização de plataforma para Windows 7: O runtime valida que ReclaimResources é usado corretamente em recursos não compartilhados, mas não executa a funcionalidade pretendida. Para obter mais informações sobre a Atualização de Plataforma para Windows 7, consulte Atualização de plataforma para Windows 7.
Requisitos
| Cliente mínimo com suporte | Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi1_2.h |
| Biblioteca | Dxgi.lib |