Método IDirect3DDevice9::SetDialogBoxMode (d3d9helper.h)

Este método permite el uso de cuadros de diálogo GDI en aplicaciones en modo de pantalla completa.

Sintaxis

HRESULT SetDialogBoxMode(
  [in] BOOL bEnableDialogs
);

Parámetros

[in] bEnableDialogs

Tipo: BOOL

TRUE para habilitar los cuadros de diálogo GDI y FALSE para deshabilitarlos.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL a menos que se cumplan todos los siguientes valores.

• La aplicación especificó un formato de búfer de reserva compatible con GDI, es decir, uno de D3DFMT_X1R5G5B5, D3DFMT_R5G6B5 o D3DFMT_X8R8G8B8.
• La aplicación no especificó ningún muestreo múltiple.
• La aplicación especificó D3DSWAPEFFECT_DISCARD.
• La aplicación especificó D3DPRESENTFLAG_LOCKABLE_BACKBUFFER.
• La aplicación no especificó D3DCREATE_ADAPTERGROUP_DEVICE.
• La aplicación no está entre BeginScene y EndScene.

Comentarios

Los cuadros de diálogo GDI se deben crear como secundarios en la ventana del dispositivo. También deben crearse dentro del mismo subproceso que creó el dispositivo, ya que esto permite que la ventana primaria administre el nuevo dibujo de la ventana secundaria.

El método no tiene ningún efecto para las aplicaciones en modo de ventana, pero esta configuración se respetará si la aplicación restablece el dispositivo en modo de pantalla completa. Si SetDialogBoxMode se realiza correctamente en una aplicación en modo de ventana, cualquier restablecimiento posterior al modo de pantalla completa se comprobará con las restricciones enumeradas anteriormente. Además, SetDialogBoxMode hace que se descarten todos los búferes de reserva de la cadena de intercambio, por lo que se espera que una aplicación actualice su contenido para todos los búferes de reserva después de esta llamada.

Requisitos

Consulte también

IDirect3DDevice9