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

  • Artículo

Permite al sistema operativo liberar la memoria de vídeo de los recursos descartando su contenido.

Sintaxis

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

Parámetros

[in] NumResources

Número de recursos de la matriz de argumentos ppResources .

[in] ppResources

Matriz de punteros a interfaces IDXGIResource para los recursos que se van a ofrecer.

[in] Priority

Valor con tipo DXGI_OFFER_RESOURCE_PRIORITY que indica el valor de los datos valiosos.

Valor devuelto

OfferResources devuelve:

  • S_OK si los recursos se ofrecieron correctamente
  • E_INVALIDARG si un recurso de la matriz o la prioridad no es válida

Comentarios

El valor de prioridad que especifica el parámetro Priority describe el valor que el autor de la llamada considera que el contenido debe ser. El sistema operativo usa el valor de prioridad para descartar los recursos en orden de prioridad. El sistema operativo descarta un recurso que se ofrece con prioridad baja antes de descartar un recurso que se ofrece con una prioridad más alta.

Si llama a OfferResources para ofrecer un recurso mientras el recurso está enlazado a la canalización, el recurso no está enlazado. No se puede llamar a OfferResources en un recurso asignado. Después de ofrecer un recurso, el recurso no se puede asignar ni enlazar a la canalización hasta que llame al método IDXGIDevice2::ReclaimResource para reclamar el recurso. No se puede llamar a OfferResources para ofrecer recursos inmutables.

Para ofrecer recursos compartidos, llame a OfferResources solo en uno de los dispositivos para compartir. Para garantizar el acceso exclusivo a los recursos, debe usar un objeto IDXGIKeyedMutex y, a continuación, llamar a OfferResources solo mientras mantiene la exclusión mutua. De hecho, no puede ofrecer recursos compartidos a menos que use IDXGIKeyedMutex porque no se admite la oferta de recursos compartidos sin usar IDXGIKeyedMutex .

Nota Es posible que el controlador de visualización en modo de usuario no ofrezca inmediatamente los recursos que especificó en una llamada a OfferResources. El controlador puede posponerlos hasta la siguiente llamada a IDXGISwapChain::P resent, IDXGISwapChain1::P resent1 o ID3D11DeviceContext::Flush.
 
Actualización de la plataforma para Windows 7: El entorno de ejecución valida que OfferResources se usa correctamente en recursos no compartidos, pero no realiza la funcionalidad prevista. Para obtener más información sobre la actualización de plataforma para Windows 7, consulta Actualización de plataforma para Windows 7.

Requisitos

   
Cliente mínimo compatible Actualización de windows 8 y plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y Actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dxgi1_2.h
Library Dxgi.lib

Consulte también

IDXGIDevice2

IDXGIDevice2::ReclaimResource