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

Article
08/23/2023

Définit le mode du matériel de périphérique d’affichage.

Syntaxe

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

Paramètres

[in] unnamedParam1

Largeur du nouveau mode d’affichage.

[in] unnamedParam2

Hauteur du nouveau mode d’affichage.

[in] unnamedParam3

Bits par pixel (bpp) du nouveau mode d’affichage.

[in] unnamedParam4

Taux d’actualisation du nouveau mode d’affichage. Définissez cette valeur sur 0 pour demander le taux d’actualisation par défaut pour le pilote.

[in] unnamedParam5

Cette valeur se compose d’indicateurs qui décrivent des options supplémentaires. Actuellement, le seul indicateur valide est DDSDM_STANDARDVGAMODE, ce qui oblige la méthode à définir le mode 13, au lieu du mode X 320x200x8. Si vous définissez une autre résolution, une profondeur de bits ou un mode X, n’utilisez pas cet indicateur ; au lieu de cela, définissez le paramètre sur 0.

Valeur retournée

Si la méthode réussit, la valeur de retour est DD_OK.

En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :

DDERR_GENERIC
DDERR_INVALIDMODE
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_LOCKEDSURFACES
DDERR_NOEXCLUSIVEMODE
DDERR_SURFACEBUSY
DDERR_UNSUPPORTED
DDERR_UNSUPPORTEDMODE
DDERR_WASSTILLDRAWING

Notes

Cette méthode doit être appelée par le thread qui a créé la fenêtre d’application.

Si une autre application change le mode d’affichage, la surface primaire est perdue et la méthode retourne DDERR_SURFACELOST jusqu’à ce que la surface primaire soit recréée pour correspondre au nouveau mode d’affichage.

Dans le cadre de l’interface IDirectDraw de version antérieure, cette méthode n’incluait pas les paramètres dwRefreshRate et dwFlags .

Spécifications


Plateforme cible	Windows
En-tête	ddraw.h
Bibliothèque	Ddraw.lib
DLL	Ddraw.dll

Voir aussi

IDirectDraw7

Partager via