Platform SDK: DirectX |
DirectDrawSurface7.SetPriority メソッドは、このテクスチャにテクスチャ管理優先順位を割り当てる。このメソッドは、管理下のテクスチャに対してのみ成功する (「注意」参照)。
object.SetPriority(Priority As Long)
失敗すればエラーが発生し、パラメータが無効の場合、またはテクスチャが Direct3D によって管理されていない場合は、Err.Number にDDERR_INVALIDOBJECT が設定される。
管理下のテクスチャをメモリから削除するときに、この優先順位が使用される。優先順位の低いテクスチャは、優先順位の高いテクスチャより先に削除される。2 つのテクスチャの優先順位が等しい場合、最近使用したテクスチャをメモリに残し、古い方を削除する。
アプリケーションは、管理下のテクスチャ (DDSCAPS2_TEXTUREMANAGE フラグで作成されたテクスチャ) に対してのみ優先順位を設定および取得できる。非管理化のテクスチャに対してこのメソッドを呼び出すと失敗し、DDERR_INVALIDOBJECT を返す。