D3DKMTSetDisplayMode, fonction (d3dkmthk.h)
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 |