Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IDXGIResource::SetEvictionPriority method

Set the priority for evicting the resource from memory.

Syntax


HRESULT SetEvictionPriority(
  [in]  UINT EvictionPriority
);

Parameters

EvictionPriority [in]

Type: UINT

The priority is one of the following values:

ValueMeaning
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 for determining how to populate overcommitted memory.

You can set priority levels other than the defined values when appropriate. For example, you can set a resource with a priority level of 0x78000001 to indicate that the resource is slightly above normal.

Windows Phone 8: This API is supported.

Requirements

Header

DXGI.h

Library

DXGI.lib

See also

IDXGIResource

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.