Método IDXGIDevice2::OfferResources (dxgi1_2.h)

Permite que o sistema operacional libere a memória de vídeo dos recursos descartando seu conteúdo.

Sintaxe

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

Parâmetros

[in] NumResources

O número de recursos na matriz de argumentos ppResources .

[in] ppResources

Uma matriz de ponteiros para interfaces IDXGIResource para os recursos a serem oferecidos.

[in] Priority

Um valor do tipo DXGI_OFFER_RESOURCE_PRIORITY que indica o quão valiosos são os dados.

Valor retornado

OfferResources retorna:

• S_OK se os recursos foram oferecidos com êxito
• E_INVALIDARG se um recurso na matriz ou a prioridade for inválido

Comentários

O valor de prioridade especificado pelo parâmetro Priority descreve o quão valioso o chamador considera o conteúdo. O sistema operacional usa o valor de prioridade para descartar recursos em ordem de prioridade. O sistema operacional descarta um recurso que é oferecido com baixa prioridade antes de descartar um recurso que é oferecido com prioridade mais alta.

Se você chamar OfferResources para oferecer um recurso enquanto o recurso estiver associado ao pipeline, o recurso será desvinculado. Você não pode chamar OfferResources em um recurso mapeado. Depois de oferecer um recurso, o recurso não poderá ser mapeado ou vinculado ao pipeline até que você chame o método IDXGIDevice2::ReclaimResource para recuperar o recurso. Você não pode chamar OfferResources para oferecer recursos imutáveis.

Para oferecer recursos compartilhados, chame OfferResources em apenas um dos dispositivos de compartilhamento. Para garantir o acesso exclusivo aos recursos, você deve usar um objeto IDXGIKeyedMutex e chamar OfferResources somente enquanto mantém o mutex. Na verdade, você não pode oferecer recursos compartilhados a menos que use IDXGIKeyedMutex porque não há suporte para a oferta de recursos compartilhados sem o uso de IDXGIKeyedMutex .

Nota O driver de exibição do modo de usuário pode não oferecer imediatamente os recursos especificados em uma chamada para OfferResources. O driver pode adiar a oferta até a próxima chamada para IDXGISwapChain::P resent, IDXGISwapChain1::P resent1 ou ID3D11DeviceContext::Flush.

 

Atualização de plataforma para Windows 7: O runtime valida se OfferResources é 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::ReclaimResource