Skip to content

Latest commit

 

History

History
82 lines (67 loc) · 3.2 KB

nf-d3d11-id3d11resource-setevictionpriority.md

File metadata and controls

82 lines (67 loc) · 3.2 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:d3d11.ID3D11Resource.SetEvictionPriority
ID3D11Resource::SetEvictionPriority (d3d11.h)
Set the eviction priority of a resource. (ID3D11Resource.SetEvictionPriority)
55340049-7283-9bea-b4ac-8b0b9cb71119
ID3D11Resource interface [Direct3D 11]
SetEvictionPriority method
ID3D11Resource.SetEvictionPriority
ID3D11Resource::SetEvictionPriority
SetEvictionPriority
SetEvictionPriority method [Direct3D 11]
SetEvictionPriority method [Direct3D 11]
ID3D11Resource interface
d3d11/ID3D11Resource::SetEvictionPriority
direct3d11.id3d11resource_setevictionpriority
direct3d11\id3d11resource_setevictionpriority.htm
direct3d11
8c68fbb8-dd8a-4d60-b081-082720e7bda5
12/05/2018
55340049-7283-9bea-b4ac-8b0b9cb71119, ID3D11Resource interface [Direct3D 11],SetEvictionPriority method, ID3D11Resource.SetEvictionPriority, ID3D11Resource::SetEvictionPriority, SetEvictionPriority, SetEvictionPriority method [Direct3D 11], SetEvictionPriority method [Direct3D 11],ID3D11Resource interface, d3d11/ID3D11Resource::SetEvictionPriority, direct3d11.id3d11resource_setevictionpriority
d3d11.h
Windows
D3D11.lib
Windows
19H1
ID3D11Resource::SetEvictionPriority
d3d11/ID3D11Resource::SetEvictionPriority
c++
APIRef
kbSyntax
COM
D3D11.lib
D3D11.dll
ID3D11Resource.SetEvictionPriority

ID3D11Resource::SetEvictionPriority

-description

Set the eviction priority of a resource.

-parameters

-param EvictionPriority [in]

Type: UINT

Eviction priority for the resource, which is one of the following values:

  • DXGI_RESOURCE_PRIORITY_MINIMUM
  • DXGI_RESOURCE_PRIORITY_LOW
  • DXGI_RESOURCE_PRIORITY_NORMAL
  • DXGI_RESOURCE_PRIORITY_HIGH
  • DXGI_RESOURCE_PRIORITY_MAXIMUM

-remarks

Resource priorities determine which resource to evict from video memory when the system has run out of video memory. The resource will not be lost; it will be removed from video memory and placed into system memory, or possibly placed onto the hard drive. The resource will be loaded back into video memory when it is required.

A resource that is set to the maximum priority, DXGI_RESOURCE_PRIORITY_MAXIMUM, is only evicted if there is no other way of resolving the incoming memory request. The Windows Display Driver Model (WDDM) tries to split an incoming memory request to its minimum size and evict lower-priority resources before evicting a resource with maximum priority.

Changing the priorities of resources should be done carefully. The wrong eviction priorities could be a detriment to performance rather than an improvement.

-see-also

ID3D11Resource