Platform SDK: DirectX

IDirectDrawSurface7::SetPriority

IDirectDrawSurface7::GetPriority メソッドは、このテクスチャのテクスチャ管理優先順位を割り当てる。このメソッドは、管理下のテクスチャに対してのみ成功する (「注意」参照)。

HRESULT SetPriority(
  DWORD dwPriority
);

パラメータ

dwPriority
テクスチャの新しいテクスチャ管理優先順位を指定する値。

戻り値

成功すれば、D3D_OK を返す。

失敗すれば、メソッドはエラーを返す。パラメータが無効な場合、またはテクスチャが Direct3D で管理されていない場合、メソッドは DDERR_INVALIDOBJECT を返す。

注意

このメソッドは、IDirectDrawSurface7 インターフェイスによって導入された。

優先順位を使用して、管理下のテクスチャをメモリからいつ削除するかを決定できる。優先順位が低いテクスチャは、優先順位が高いテクスチャより先に削除される。2 つのテクスチャの優先順位が同じ場合は、最終使用時が新しい方のテクスチャがメモリに保持され、もう一方のテクスチャが削除される。

アプリケーションでは、管理下のテクスチャ (DDSCAPS2_TEXTUREMANAGE フラグで作成したもの) でのみ優先順位を設定および取得できる。非管理下のテクスチャに対してこのメソッドを呼び出すと、メソッドは失敗し、DDERR_INVALIDOBJECT を返す。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。

参照

IDirectDrawSurface7::GetPriority自動テクスチャ管理テクスチャ