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

  • Article

Restaure l’accès aux ressources qui étaient 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 l’argument ppResources et les tableaux d’arguments 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 au même index que celui 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 transmettre la valeur NULL si l’appelant a l’intention de remplir les ressources avec un nouveau contenu, que l’ancien contenu ait ou non été ignoré.

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 case activée les valeurs du tableau sur pDiscarded pour déterminer si le contenu de chaque ressource a été ignoré. Si le contenu d’une ressource a été ignoré alors qu’il était 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 lorsque vous conservez le mutex.

Mise à jour de la plateforme pour Windows 7 : Le runtime valide que ReclaimResources est utilisé correctement sur les ressources non partagées, mais n’exécute 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.

Spécifications

   
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