Méthode IDirectDrawSurface7 ::SetPriority (ddraw.h)
Affecte la priorité de gestion des textures pour cette texture. Cette méthode réussit uniquement sur les textures managées.
Syntaxe
HRESULT SetPriority(
[in] DWORD unnamedParam1
);
Paramètres
[in] unnamedParam1
Valeur qui spécifie la nouvelle priorité de gestion des textures pour la texture.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la valeur de retour est une erreur. La méthode retourne DDERR_INVALIDOBJECT si le paramètre n’est pas valide ou si la texture n’est pas gérée par Direct3D.
Remarques
SetPriority a été introduit avec l’interface IDirectDrawSurface7 .
Les priorités sont utilisées pour déterminer quand les textures managées doivent être supprimées de la mémoire. Une texture affectée d’une priorité basse est supprimée avant une texture avec une priorité élevée. Si deux textures ont la même priorité, la texture utilisée plus récemment est conservée en mémoire ; l’autre texture est supprimée.
Les applications peuvent définir et récupérer des priorités uniquement pour les textures managées (les surfaces qui ont été créées avec l’indicateur DDSCAPS2_TEXTUREMANAGE). Si vous appelez SetPriority sur une texture non managée, SetPriority échoue et retourne DDERR_INVALIDOBJECT.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |