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 l’analyse.
Valeur de retour
D3DKMTSetDisplayMode retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | Le mode d’affichage a été correctement défini. |
| STATUS_DEVICE_REMOVED | La carte graphique a été arrêtée ou l’appareil 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 dans l’attribut de format spécifié par le PrivateDriverFormatAttribute membre de D3DKMT_SETDISPLAYMODE spécifie. L’ICD doit ensuite appeler D3DKMTSetDisplayMode à nouveau. L’ICD peut allouer une nouvelle allocation, effectuer un transfert de bloc de bits de conversion (bitblt) de l’ancien serveur principal vers le nouveau, puis détruire l’ancien principal 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’à D3DKMTSetDisplayMode retourne une valeur de retour différente. |
Cette fonction peut également retourner d’autres valeurs NTSTATUS.
Remarques
Avant d’appeler openGL ICD D3DKMTSetDisplayMode pour définir un nouveau mode d’affichage qui utilise un format étendu, une méthode à é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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Universel |
| d’en-tête | d3dkmthk.h (include D3dkmthk.h) |
| bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |