IDirectDrawSurface7::SetLOD-Methode (ddraw.h)

Legt die maximale Detailebene (Maximum Level of Detail, LOD) für eine verwaltete Mipmap-Oberfläche fest. Diese Methode ist nur bei verwalteten Texturen erfolgreich.

Syntax

HRESULT SetLOD(
  [in] DWORD unnamedParam1
);

Parameter

[in] unnamedParam1

Der maximale LOD-Wert, der für die mipmap-Kette festgelegt werden soll, wenn der Aufruf erfolgreich ist.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.

Wenn ein Fehler auftritt, kann die -Methode einen der folgenden Fehlerwerte zurückgeben:

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS

Hinweise

Anwendungen können diese Methode nur für verwaltete Texturen aufrufen (oberflächen, die mit dem flag DDSCAPS2_TEXTUREMANAGE erstellt wurden). Wenn Sie SetLOD für eine nicht verwaltete Textur aufrufen, schlägt SetLOD fehl und gibt DDERR_INVALIDOBJECT zurück.

SetLOD übermittelt dem Direct3D-Textur-Manager die detaillierteste Mipmap in dieser Kette, die in den lokalen Videospeicher geladen werden soll. Wenn Sie dwMaxLOD beispielsweise in einer Mipmap-Kette mit fünf Ebenen auf 2 festlegen, sollte der Textur-Manager zu einem bestimmten Zeitpunkt nur die Mipmap-Ebenen 2 bis 4 in den lokalen Videospeicher laden. Wenn die detaillierteste Mipmap in der Kette die Abmessungen 256×256 aufweist, bedeutet das Festlegen der maximalen Stufe auf 2, dass die größte Mipmap, die jemals im Videospeicher vorhanden ist, die Abmessungen 64×64 hat.

Anforderungen

Weitere Informationen

IDirectDrawSurface7