Méthode IDirect3DDevice9::SetDialogBoxMode (d3d9.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 toutes les conditions suivantes sont remplies.
- L’application a spécifié un format de mémoire tampon arrière compatible avec GDI, en d’autres termes, l’un des D3DFMT_X1R5G5B5, D3DFMT_R5G6B5 ou D3DFMT_X8R8G8B8.
- L’application n’a spécifié aucun échantillonnage multiple.
- 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’enfants dans la fenêtre de l’appareil. Ils doivent également être créés dans le thread 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 sur 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 | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |