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 |