Partager via


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

Cette méthode permet d’utiliser des boîtes de dialogue GDI dans les applications en mode plein écran.

Syntaxe

HRESULT SetDialogBoxMode(
  [in] BOOL bEnableDialogs
);

Paramètres

[in] bEnableDialogs

Type : BOOL

TRUE pour activer les boîtes de dialogue GDI et FALSE pour les désactiver.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL, sauf si tous les éléments suivants sont true.

  • L’application a spécifié un format de mémoire tampon arrière compatible avec GDI, c’est-à-dire l’un des D3DFMT_X1R5G5B5, D3DFMT_R5G6B5 ou D3DFMT_X8R8G8B8.
  • L’application n’a spécifié aucun multi-échantillonnage.
  • L’application spécifiée D3DSWAPEFFECT_DISCARD.
  • L’application spécifiée D3DPRESENTFLAG_LOCKABLE_BACKBUFFER.
  • L’application n’a pas spécifié D3DCREATE_ADAPTERGROUP_DEVICE.
  • L’application ne se trouve pas entre BeginScene et EndScene.

Notes

Les boîtes de dialogue GDI doivent être créées en tant qu’enfant de la fenêtre de l’appareil. Ils doivent également être créés dans le même thread que celui qui a créé l’appareil, car cela permet à la fenêtre parente de gérer le redessinage de la fenêtre enfant.

La méthode n’a aucun effet pour les applications en mode fenêtré, mais ce paramètre sera respecté si l’application réinitialise l’appareil en mode plein écran. Si SetDialogBoxMode réussit dans une application en mode fenêtré, toute réinitialisation ultérieure en mode plein écran sera vérifiée par rapport aux restrictions répertoriées ci-dessus. En outre, SetDialogBoxMode entraîne l’abandon de toutes les mémoires tampons d’arrière-mémoire de la chaîne d’échange, de sorte qu’une application est censée actualiser son contenu pour toutes les mémoires tampons d’arrière-mémoire après cet appel.

Spécifications

   
Plateforme cible Windows
En-tête d3d9helper.h (incluez D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9