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

Restaura el acceso a los recursos que se ofrecieron anteriormente mediante una llamada a IDXGIDevice2::OfferResources.

Sintaxis

HRESULT ReclaimResources(
  [in]            UINT          NumResources,
  [in]            IDXGIResource * const *ppResources,
  [out, optional] BOOL          *pDiscarded
);

Parámetros

[in] NumResources

Número de recursos de las matrices de argumentos ppResources y pDiscarded .

[in] ppResources

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

[out, optional] pDiscarded

Puntero a una matriz que recibe valores booleanos. Cada valor de la matriz corresponde a un recurso en el mismo índice que el parámetro ppResources especifica. El tiempo de ejecución establece cada valor booleano en TRUE si el contenido del recurso correspondiente se ha descartado y ahora no está definido, o en FALSE si el contenido anterior del recurso correspondiente sigue intacto. El autor de la llamada puede pasar NULL, si el autor de la llamada pretende rellenar los recursos con contenido nuevo, independientemente de si se ha descartado el contenido anterior.

Valor devuelto

ReclaimResources devuelve:

• S_OK si los recursos se reclamaron correctamente
• E_INVALIDARG si los recursos no son válidos

Comentarios

Después de llamar a IDXGIDevice2::OfferResources para ofrecer uno o varios recursos, debe llamar a ReclaimResources para poder volver a usar esos recursos. Debe comprobar los valores de la matriz en pDiscarded para determinar si se ha descartado el contenido de cada recurso. Si el contenido de un recurso se descarta mientras se ofrece, su contenido actual no está definido. Por lo tanto, debe sobrescribir el contenido del recurso antes de usar el recurso.

Para reclamar recursos compartidos, llame a ReclaimResources solo en uno de los dispositivos que comparten. Para garantizar el acceso exclusivo a los recursos, debe usar un objeto IDXGIKeyedMutex y, a continuación, llamar a ReclaimResources solo mientras mantiene la exclusión mutua.

Actualización de la plataforma para Windows 7: El tiempo de ejecución valida que ReclaimResources se usa correctamente en recursos no compartidos, pero no realiza la funcionalidad prevista. Para obtener más información sobre platform Update para Windows 7, consulta Platform Update para Windows 7.

Requisitos

Cliente mínimo compatible	Windows 8 y Platform Update 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::OfferResources