Méthode IDirectDrawSurface7::GetLOD (ddraw.h)

Récupère le niveau maximal de détail (LOD) actuellement défini pour une surface mipmap managée. Cette méthode réussit uniquement sur les textures managées.

Syntaxe

HRESULT GetLOD(
  [out] LPDWORD unnamedParam1
);

Paramètres

[out] unnamedParam1

Pointeur vers une variable qui reçoit la valeur LOD maximale si l’appel réussit.

Valeur retournée

Si la méthode réussit, la valeur de retour est DD_OK.

En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS

Notes

Les applications peuvent appeler cette méthode uniquement pour les textures managées (les surfaces qui ont été créées avec l’indicateur DDSCAPS2_TEXTUREMANAGE). Si vous appelez GetLOD sur une texture non managée, GetLOD échoue et retourne DDERR_INVALIDOBJECT.

GetLOD communique au gestionnaire de textures Direct3D le mipmap le plus détaillé de cette chaîne qu’il doit charger dans la mémoire vidéo locale. Par exemple, dans une chaîne mipmap à cinq niveaux, une valeur de 2 dans la variable à lpdwMaxLOD indique que le gestionnaire de textures charge uniquement les niveaux mipmap 2 à 4 dans la mémoire vidéo locale à un moment donné. De même, si le mipmap le plus détaillé de la chaîne a les dimensions 256×256, une valeur de 2 dans lpdwMaxLOD signifie que le plus grand mipmap jamais présent dans la mémoire vidéo a des dimensions 64×64.

Spécifications

Voir aussi

IDirectDrawSurface7