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

Confira também

IDXGIDevice2

IDXGIDevice2::OfferResources