IDirectDrawSurface7::SetLOD メソッド (ddraw.h)

マネージド ミップマップ サーフェスの最大詳細レベル (LOD) を設定します。 このメソッドは、マネージド テクスチャでのみ成功します。

構文

HRESULT SetLOD(
  [in] DWORD unnamedParam1
);

パラメーター

[in] unnamedParam1

呼び出しが成功した場合にミップマップ チェーンに設定される最大 LOD 値。

戻り値

メソッドが成功した場合、戻り値はDD_OK。

失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS

解説

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

SetLOD は 、ローカル ビデオ メモリに読み込む必要がある、このチェーンの最も詳細なミップマップを Direct3D テクスチャ マネージャーに伝えます。 たとえば、5 レベルのミップマップ チェーンで dwMaxLOD を 2 に設定した場合、テクスチャ マネージャーは、任意の時点で mipmap レベル 2 から 4 のみをローカル ビデオ メモリに読み込む必要があります。 同様に、チェーン内の最も詳細なミップマップの寸法が 256×256 の場合、最大レベルを 2 に設定すると、ビデオ メモリに存在する最大のミップマップのサイズは 64×64 になります。

要件

関連項目

IDirectDrawSurface7