Método IDirectDraw7::EvaluateMode (ddraw.h)

Se usa después de una llamada a IDirectDraw7::StartModeTest para pasar o producir un error en cada modo que la prueba presenta y recorrer los modos hasta que se complete la prueba.

Sintaxis

HRESULT EvaluateMode(
  [in]  DWORD unnamedParam1,
  [out] DWORD *unnamedParam2
);

Parámetros

[in] unnamedParam1

Una de las marcas siguientes que indican el estado del modo que se está probando:

DDEM_MODEPASSED

Se ha superado el modo que se está probando.

DDEM_MODEFAILED

Error en el modo que se está probando.

[out] unnamedParam2

Puntero a una variable que recibe un valor que indica los segundos que quedan antes de que se produzca un error en el modo actual automáticamente, a menos que se pase explícitamente o se produzca un error.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es DD_OK.

Si se produce un error o se completa, el método puede devolver uno de los siguientes valores de error:

• DDERR_TESTFINISHED
• DDERR_NEWMODE
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_NOTFOUND

Comentarios

Puedes usar EvaluateMode junto con el método IDirectDraw7::StartModeTest para determinar la velocidad de actualización máxima que puede admitir una combinación de adaptadores de pantalla y monitor EDID para cada resolución de pantalla.

En concreto, una llamada a IDirectDraw7::StartModeTest dirige DirectDraw para establecer un conjunto de resoluciones probables y mostrar un modo basado en la primera resolución del conjunto. Las llamadas posteriores a EvaluateMode se pueden usar para pasar o producir un error en cada modo y para avanzar la prueba al siguiente modo de presentación. El método recorre las resoluciones que se pueden probar a partir de la velocidad de actualización más alta admitida para una resolución determinada. Una vez superada una frecuencia de actualización para una resolución determinada, se omiten las pruebas de velocidades de actualización más bajas para esa resolución.

Cuando se inicia la prueba, o cada vez que se pasa o se produce un error en un modo, DirectDraw comienza un tiempo de espera de 15 segundos. Una aplicación puede supervisar el tiempo restante sin pasar o fallar el modo actual llamando a EvaluateMode con un valor de 0 para el argumento dwFlags. Tenga en cuenta que DirectDraw solo cambia los modos o finaliza la prueba cuando se llama a EvaluateMode . Sin embargo, si una aplicación llama a EvaluateMode una vez transcurrido el período de tiempo de espera, se produce un error en el modo actual, independientemente del valor pasado al parámetro dwFlags .

Requisitos

Consulte también

IDirectDraw7