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

Establece el modo del hardware del dispositivo para mostrar.

Sintaxis

HRESULT SetDisplayMode(
  [in] DWORD unnamedParam1,
  [in] DWORD unnamedParam2,
  [in] DWORD unnamedParam3,
  [in] DWORD unnamedParam4,
  [in] DWORD unnamedParam5
);

Parámetros

[in] unnamedParam1

Ancho del nuevo modo de presentación.

[in] unnamedParam2

Alto del nuevo modo de presentación.

[in] unnamedParam3

Bits por píxel (bpp) del nuevo modo de presentación.

[in] unnamedParam4

Frecuencia de actualización del nuevo modo de presentación. Establezca este valor en 0 para solicitar la frecuencia de actualización predeterminada para el controlador.

[in] unnamedParam5

Este valor consta de marcas que describen opciones adicionales. Actualmente, la única marca válida es DDSDM_STANDARDVGAMODE, lo que hace que el método establezca mode 13, en lugar del modo X 320x200x8. Si establece otra resolución, profundidad de bits o modo X de modo, no use esta marca; en su lugar, establezca el parámetro en 0.

Valor devuelto

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

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

• DDERR_GENERIC
• DDERR_INVALIDMODE
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_LOCKEDSURFACES
• DDERR_NOEXCLUSIVEMODE
• DDERR_SURFACEBUSY
• DDERR_UNSUPPORTED
• DDERR_UNSUPPORTEDMODE
• DDERR_WASSTILLDRAWING

Comentarios

El mismo subproceso que creó la ventana de la aplicación debe llamar a este método.

Si otra aplicación cambia el modo de presentación, se pierde la superficie principal y el método devuelve DDERR_SURFACELOST hasta que se vuelve a crear la superficie principal para que coincida con el nuevo modo de presentación.

Como parte de la interfaz IDirectDraw de la versión anterior, este método no incluía los parámetros dwRefreshRate y dwFlags .

Requisitos

Consulte también

IDirectDraw7