IDirect3DResource8::SetPriority

Assigns the resource-management priority for this resource.

DWORD SetPriority(
  DWORD PriorityNew
);

Parameters

PriorityNew

[in] DWORD value that specifies the new resource-management priority for the resource.

Return Values

Returns the previous priority value for the resource.

Applies To

This method applies to the following interfaces, which inherit from IDirect3DResource8.

• IDirect3DBaseTexture8
• IDirect3DCubeTexture8
• IDirect3DIndexBuffer8
• IDirect3DTexture8
• IDirect3DVertexBuffer8
• IDirect3DVolumeTexture8

Remarks

SetPriority is used for priority control of managed resources. This method returns 0 on non-managed resources.

Priorities are used to determine when managed resources are to be removed from memory. A resource assigned a low priority is removed before a resource with a high priority. If two resources have the same priority, the resource that was used more recently is kept in memory; the other resource is removed. Managed resources have a default priority of 0.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.

See Also

IDirect3DResource8::GetPriority