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

  • Article

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

Voir aussi

IDirect3DDevice9