Platform SDK: DirectX

IDirectDrawSurface7::SetLOD

IDirectDrawSurface7::SetLOD メソッドは、管理ミップマップ サーフェスの最大詳細レベルを設定する。このメソッドは、管理下のテクスチャに対してのみ成功する (「注意」参照)。

HRESULT SetLOD(
    DWORD dwMaxLOD
);
dwMaxLOD
呼び出しが成功した場合に、ミップマップ チェーンに設定する最大詳細レベルの値。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下の値のいずれかを返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

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

このメソッドは、ローカル ビデオ メモリにロードするこのチェーンの中で最も詳細なミップマップを Direct3D テクスチャ マネージャに通知する。たとえば、5 レベルのミップマップ チェーンにおいて dwMaxLOD を 2 に設定すると、テクスチャ マネージャは指定時間になるとレベル 2 から 4 のミップマップのみローカル ビデオ メモリにロードする。同様に、チェーンの中で最も詳細なミップマップの大きさが 256 × 256 の場合、最大レベルを 2 に設定すると、これまでにビデオ メモリ内にある最大のミップマップは 64 × 64 であることを示すことになる。

動作環境

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

参照

IDirectDrawSurface7::GetLODミップマップによるテクスチャ フィルタリング自動テクスチャ管理テクスチャ