D3DKMTSetDisplayMode, fonction (d3dkmthk.h)

  • Article

La fonction D3DKMTSetDisplayMode définit l’allocation utilisée pour analyser l’affichage.

Syntaxe

NTSTATUS D3DKMTSetDisplayMode(
  [in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);

Paramètres

[in, out] unnamedParam1

Pointeur vers une structure D3DKMT_SETDISPLAYMODE qui décrit l’allocation utilisée pour analyser.

Valeur retournée

D3DKMTSetDisplayMode retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS Le mode d’affichage a été correctement défini.
STATUS_DEVICE_REMOVED La carte graphique a été arrêtée ou le périphérique d’affichage a été réinitialisé.
STATUS_INVALID_PARAMETER Les paramètres ont été validés et déterminés comme incorrects.
STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER Avant l’appel à D3DKMTSetDisplayMode, l’appareil n’a pas acquis la propriété exclusive de la vue. Par conséquent, l’appareil n’a pas pu définir le mode d’affichage.
D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT Le pilote client installable OpenGL (ICD) doit convertir le format de la surface associée à l’allocation que le membre hPrimaryAllocation de D3DKMT_SETDISPLAYMODE spécifie en l’attribut format que le membre PrivateDriverFormatAttribute de D3DKMT_SETDISPLAYMODE spécifie. L’ICD doit ensuite appeler à nouveau D3DKMTSetDisplayMode . L’ICD peut allouer une nouvelle allocation, effectuer un transfert de bloc de conversion de bits (bitblt) de l’ancien principal vers le nouveau, puis détruire l’ancienne primaire tant que l’ICD utilise le nouveau handle d’allocation pour cette allocation pour toutes les opérations suivantes. L’ICD doit répéter ce processus jusqu’à ce que D3DKMTSetDisplayMode retourne une valeur de retour différente.

Cette fonction peut également retourner d’autres valeurs NTSTATUS .

Remarques

Avant que l’ICD OpenGL appelle D3DKMTSetDisplayMode pour définir un nouveau mode d’affichage qui utilise un format étendu, une méthode d’échantillonnage multiple ou les deux, l’ICD doit s’assurer que le mode d’affichage GDI actuel a la même résolution que le nouveau mode d’affichage. Sinon, D3DKMTSetDisplayMode retourne STATUS_INVALID_PARAMETER.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Universal
En-tête d3dkmthk.h (include D3dkmthk.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

D3DKMT_SETDISPLAYMODE