Edit

IDXGIResource::GetEvictionPriority method (dxgi.h)

  • Article

Get the eviction priority.

Syntax

HRESULT GetEvictionPriority(
  [out] UINT *pEvictionPriority
);

Parameters

[out] pEvictionPriority

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.

Return value

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.

Requirements

Requirement Value
Target Platform Windows
Header dxgi.h
Library DXGI.lib

See also

IDXGIResource