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

Article
08/23/2023

Permet au système d’exploitation de libérer la mémoire vidéo des ressources en ignorant leur contenu.

Syntaxe

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

Paramètres

[in] NumResources

Nombre de ressources dans le tableau d’arguments ppResources .

[in] ppResources

Tableau de pointeurs vers les interfaces IDXGIResource pour les ressources à offrir.

[in] Priority

Valeur de type DXGI_OFFER_RESOURCE_PRIORITY qui indique la valeur des données.

Valeur retournée

OfferResources retourne :

S_OK si les ressources ont été proposées avec succès
E_INVALIDARG si une ressource dans le tableau ou si la priorité n’est pas valide

Notes

La valeur de priorité spécifiée par le paramètre Priority décrit la valeur que l’appelant considère comme étant du contenu. Le système d’exploitation utilise la valeur de priorité pour ignorer les ressources par ordre de priorité. Le système d’exploitation ignore une ressource qui est proposée avec une faible priorité avant d’ignorer une ressource qui est proposée avec une priorité plus élevée.

Si vous appelez OfferResources pour proposer une ressource alors que la ressource est liée au pipeline, la ressource n’est pas liée. Vous ne pouvez pas appeler OfferResources sur une ressource mappée. Après avoir proposé une ressource, la ressource ne peut pas être mappée ou liée au pipeline tant que vous n’appelez pas la méthode IDXGIDevice2::ReclaimResource pour récupérer la ressource. Vous ne pouvez pas appeler OfferResources pour offrir des ressources immuables.

Pour offrir des ressources partagées, appelez OfferResources sur un seul des appareils de partage. Pour garantir un accès exclusif aux ressources, vous devez utiliser un objet IDXGIKeyedMutex , puis appeler OfferResources uniquement lorsque vous conservez le mutex. En fait, vous ne pouvez pas proposer de ressources partagées, sauf si vous utilisez IDXGIKeyedMutex , car l’offre de ressources partagées sans idXGIKeyedMutex n’est pas prise en charge.

Note Le pilote d’affichage en mode utilisateur peut ne pas offrir immédiatement les ressources que vous avez spécifiées dans un appel à OfferResources. Le pilote peut reporter leur offre jusqu’au prochain appel à IDXGISwapChain::P resent, IDXGISwapChain1::P resent1 ou ID3D11DeviceContext::Flush.

Mise à jour de la plateforme pour Windows 7 : Le runtime valide qu’OfferResources 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::ReclaimResource

Partager via