Share via

Méthode IDirect3D9Ex::GetAdapterDisplayModeEx (d3d9.h)

  • Article

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

Voir aussi

IDirect3D9Ex