Méthode IDirectDraw7::EvaluateMode (ddraw.h)
Utilisé après un appel à IDirectDraw7::StartModeTest pour réussir ou échouer chaque mode présenté par le test et pour parcourir les modes jusqu’à la fin du test.
Syntaxe
HRESULT EvaluateMode(
[in] DWORD unnamedParam1,
[out] DWORD *unnamedParam2
);
Paramètres
[in] unnamedParam1
L’un des indicateurs suivants qui indiquent le status du mode testé :
DDEM_MODEPASSED
Le mode testé est réussi.
DDEM_MODEFAILED
Le mode testé a échoué.
[out] unnamedParam2
Pointeur vers une variable qui reçoit une valeur qui indique les secondes restantes avant l’échec automatique du mode actuel, sauf s’il est explicitement passé ou échoué.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec ou à l’achèvement, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_TESTFINISHED
- DDERR_NEWMODE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOTFOUND
Notes
Vous pouvez utiliser EvaluateMode conjointement avec la méthode IDirectDraw7::StartModeTest pour déterminer la fréquence d’actualisation maximale qu’une combinaison de moniteur EDID et d’adaptateur d’affichage peut prendre en charge pour chaque résolution d’écran.
Plus précisément, un appel à IDirectDraw7::StartModeTest permet à DirectDraw d’établir un ensemble de résolutions testables et d’afficher un mode basé sur la première résolution de l’ensemble. Les appels suivants à EvaluateMode peuvent être utilisés pour réussir ou échouer chaque mode et faire passer le test au mode d’affichage suivant. La méthode décrit les résolutions testables en commençant par le taux d’actualisation le plus élevé pris en charge pour une résolution donnée. Une fois qu’un taux d’actualisation pour une résolution donnée est réussi, le test des taux d’actualisation inférieurs pour cette résolution est ignoré.
Lorsque le test est lancé, ou chaque fois qu’un mode est passé ou a échoué, DirectDraw commence un délai d’attente de 15 secondes. Une application peut surveiller le temps restant sans passer ou échouer le mode actuel en appelant EvaluateMode avec la valeur 0 pour l’argument dwFlags. Notez que DirectDraw ne modifie les modes ou met fin au test que lorsque EvaluateMode est appelé. Toutefois, si une application appelle EvaluateMode après l’expiration du délai d’attente, le mode actuel échoue, quelle que soit la valeur passée au paramètre dwFlags .
Spécifications
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |