nf-dxgi-idxgiresource-getevictionpriority.md

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:dxgi.IDXGIResource.GetEvictionPriority	IDXGIResource::GetEvictionPriority (dxgi.h)	Get the eviction priority.	271e783f-4a0f-1453-c22a-244b5f091171 DXGI_RESOURCE_PRIORITY_HIGH (0xa0000000) DXGI_RESOURCE_PRIORITY_LOW (0x50000000) DXGI_RESOURCE_PRIORITY_MAXIMUM (0xc8000000) DXGI_RESOURCE_PRIORITY_MINIMUM (0x28000000) DXGI_RESOURCE_PRIORITY_NORMAL (0x78000000) GetEvictionPriority GetEvictionPriority method [DXGI] GetEvictionPriority method [DXGI] IDXGIResource interface IDXGIResource interface [DXGI] GetEvictionPriority method IDXGIResource.GetEvictionPriority IDXGIResource::GetEvictionPriority direct3ddxgi.idxgiresource_getevictionpriority dxgi/IDXGIResource::GetEvictionPriority	direct3ddxgi\idxgiresource_getevictionpriority.htm	direct3ddxgi	VS|directx_sdk|~\idxgiresource_getevictionpriority.htm	12/05/2018	271e783f-4a0f-1453-c22a-244b5f091171, DXGI_RESOURCE_PRIORITY_HIGH (0xa0000000), DXGI_RESOURCE_PRIORITY_LOW (0x50000000), DXGI_RESOURCE_PRIORITY_MAXIMUM (0xc8000000), DXGI_RESOURCE_PRIORITY_MINIMUM (0x28000000), DXGI_RESOURCE_PRIORITY_NORMAL (0x78000000), GetEvictionPriority, GetEvictionPriority method [DXGI], GetEvictionPriority method [DXGI],IDXGIResource interface, IDXGIResource interface [DXGI],GetEvictionPriority method, IDXGIResource.GetEvictionPriority, IDXGIResource::GetEvictionPriority, direct3ddxgi.idxgiresource_getevictionpriority, dxgi/IDXGIResource::GetEvictionPriority	dxgi.h		Windows												DXGI.lib			Windows			19H1	IDXGIResource::GetEvictionPriority dxgi/IDXGIResource::GetEvictionPriority	c++	APIRef kbSyntax	COM	DXGI.lib DXGI.dll	IDXGIResource.GetEvictionPriority

IDXGIResource::GetEvictionPriority

-description

Get the eviction priority.

-parameters

-param pEvictionPriority [out]

Type: UINT*

A pointer to the eviction priority, which determines when a resource can be evicted from memory.

The following defined values are possible.

Value	Meaning
DXGI_RESOURCE_PRIORITY_MINIMUM (0x28000000)	The resource is unused and can be evicted as soon as another resource requires the memory that the resource occupies.
DXGI_RESOURCE_PRIORITY_LOW (0x50000000)	The eviction priority of the resource is low. The placement of the resource is not critical, and minimal work is performed to find a location for the resource. For example, if a GPU can render with a vertex buffer from either local or non-local memory with little difference in performance, that vertex buffer is low priority. Other more critical resources (for example, a render target or texture) can then occupy the faster memory.
DXGI_RESOURCE_PRIORITY_NORMAL (0x78000000)	The eviction priority of the resource is normal. The placement of the resource is important, but not critical, for performance. The resource is placed in its preferred location instead of a low-priority resource.
DXGI_RESOURCE_PRIORITY_HIGH (0xa0000000)	The eviction priority of the resource is high. The resource is placed in its preferred location instead of a low-priority or normal-priority resource.
DXGI_RESOURCE_PRIORITY_MAXIMUM (0xc8000000)	The resource is evicted from memory only if there is no other way of resolving the memory requirement.

-returns

Type: HRESULT

Returns one of the following DXGI_ERROR.

-remarks

The eviction priority is a memory-management variable that is used by DXGI to determine how to manage overcommitted memory.

Priority levels other than the defined values are used when appropriate. For example, a resource with a priority level of 0x78000001 indicates that the resource is slightly above normal.

-see-also

IDXGIResource