Platform SDK: DirectX

DirectDrawSurface7.GetLOD

DirectDrawSurface7.GetLOD メソッドは、管理されるミップマップ サーフェスに現在設定されている最大詳細レベルを取得する。このメソッドは、管理下のテクスチャに対してのみ成功する (「注意」参照)。

object.GetLOD() As Long

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。

戻り値

成功すれば、ミップマップ チェーンの最大詳細レベルを返す。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_INVALIDPARAMS
DDERR_INVALIDOBJECT

注意

アプリケーションは、管理下のテクスチャ (DDSCAPS2_TEXTUREMANAGE フラグで作成されたテクスチャ) に対してのみこのメソッドを呼び出すことができる。非管理下のテクスチャに対してこのメソッドを呼び出すと、メソッドが失敗し、DDERR_INVALIDOBJECT エラーが発生する。

このメソッドは、このチェーン内でローカル ビデオ メモリにロードできる最大詳細ミップマップを Direct3D テクスチャ マネージャに通知する。たとえば、5 レベルのミップマップ チェーンで、戻り値が 2 の場合、テクスチャ マネージャは所定の時間でミップマップ レベル 2 から 4 だけをローカル ビデオ メモリにロードする。同様に、チェーン内の最大詳細ミップマップのサイズが 256×256 で、戻り値が 2 の場合、ビデオ メモリに存在する最大ミップマップのサイズは 64×64 になる。

参照

DirectDrawSurface7.SetLODミップマップによるテクスチャ フィルタリング自動テクスチャ管理テクスチャ