Méthode IDirect3D9Ex::GetAdapterDisplayModeEx (d3d9.h)
Récupère les paramètres actuels de mode d’affichage et de rotation de l’adaptateur.
Syntaxe
HRESULT GetAdapterDisplayModeEx(
[in] UINT Adapter,
[in, out] D3DDISPLAYMODEEX *pMode,
[in, out] D3DDISPLAYROTATION *pRotation
);
Paramètres
[in] Adapter
Type : UINT
Nombre ordinal qui désigne l’adaptateur d’affichage à interroger. D3DADAPTER_DEFAULT est toujours l’adaptateur d’affichage principal.
[in, out] pMode
Type : D3DDISPLAYMODEEX*
Pointeur vers une structure D3DDISPLAYMODEEX contenant des données sur le mode d’affichage de l’adaptateur. Par opposition au mode d’affichage de l’appareil, qui peut ne pas être actif si l’appareil ne possède pas le mode plein écran. Peut être défini sur NULL.
[in, out] pRotation
Type : D3DDISPLAYROTATION*
Pointeur vers une structure D3DDISPLAYROTATION indiquant le type de rotation d’écran que l’application effectuera. La valeur retournée par ce pointeur est importante lorsque l’indicateur D3DPRESENTFLAG_NOAUTOROTATE est utilisé ; sinon, il peut être défini sur NULL.
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est D3D_OK.
Si l’adaptateur est hors plage ou si pMode n’est pas valide, cette méthode retourne D3DERR_INVALIDCALL.
Notes
GetAdapterDisplayModeEx ne retourne pas le format correct lorsque l’affichage est dans un format étendu, par exemple 2:10:10:10:10. Au lieu de cela, il retourne le format X8R8G8B8.
Pour les applications fenêtrés, une valeur de S_PRESENT_MODE_CHANGED retournée par PresentEx ou CheckDeviceState indique que le mode d’affichage a changé et que le mode d’affichage actuel peut avoir un autre format. Pour éviter un blt présent de conversion de couleur, les applications fenêtrés peuvent éventuellement obtenir de nouvelles informations sur le mode d’affichage en utilisant cette méthode et en ajustant le format de sa chaîne d’échange en conséquence. Cette méthode retourne D3DERR_NOTAVAILABLE si cette tête ne fait plus partie du bureau ou si le moniteur est déconnecté.
Spécifications
| Plateforme cible | Windows |
| En-tête | d3d9.h |
| Bibliothèque | D3D9.lib |