IDXGIDevice2::ReclaimResources, méthode (dxgi1_2.h)

Restaure l’accès aux ressources précédemment proposées en appelant IDXGIDevice2::OfferResources.

Syntaxe

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

Paramètres

[in] NumResources

Nombre de ressources dans les tableaux d’arguments ppResources et pDiscarded .

[in] ppResources

Tableau de pointeurs vers les interfaces IDXGIResource pour les ressources à récupérer.

[out, optional] pDiscarded

Pointeur vers un tableau qui reçoit des valeurs booléennes. Chaque valeur du tableau correspond à une ressource à l’index spécifié par le paramètre ppResources . Le runtime définit chaque valeur booléenne sur TRUE si le contenu de la ressource correspondante a été ignoré et n’est désormais pas défini, ou sur FALSE si l’ancien contenu de la ressource correspondante est toujours intact. L’appelant peut passer null si l’appelant a l’intention de remplir les ressources avec un nouveau contenu, que l’ancien contenu ait été ignoré ou non.

Valeur retournée

ReclaimResources retourne :

  • S_OK si les ressources ont été récupérées avec succès
  • E_INVALIDARG si les ressources ne sont pas valides

Notes

Après avoir appelé IDXGIDevice2::OfferResources pour offrir une ou plusieurs ressources, vous devez appeler ReclaimResources avant de pouvoir réutiliser ces ressources. Vous devez vérifier les valeurs du tableau à pDiscarded pour déterminer si le contenu de chaque ressource a été ignoré. Si le contenu d’une ressource a été ignoré pendant qu’il a été proposé, son contenu actuel n’est pas défini. Par conséquent, vous devez remplacer le contenu de la ressource avant d’utiliser la ressource.

Pour récupérer des ressources partagées, appelez ReclaimResources uniquement sur l’un des appareils de partage. Pour garantir un accès exclusif aux ressources, vous devez utiliser un objet IDXGIKeyedMutex , puis appeler ReclaimResources uniquement pendant que vous maintenez le mutex.

Mise à jour de plateforme pour Windows 7 : Le runtime valide que ReclaimResources est utilisé correctement sur les ressources non partagées, mais n’effectue pas les fonctionnalités prévues. Pour plus d’informations sur la mise à jour de plateforme pour Windows 7, consultez Mise à jour de plateforme pour Windows 7.

Configuration requise

   
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dxgi1_2.h
Bibliothèque Dxgi.lib

Voir aussi

IDXGIDevice2

IDXGIDevice2::OfferResources