Fonction SetMonitorDisplayAreaPosition (highlevelmonitorconfigurationapi.h)

Avertissement

Les fonctions de configuration du moniteur physique fonctionnent à l’aide de la norme VESA Monitor Control Command Set (MCCS) sur une interface I²C. De nombreux moniteurs n’implémentent pas entièrement cette norme ; votre utilisation de ces commandes peut entraîner un comportement de surveillance non défini. Nous vous déconseillons d’utiliser ces fonctions pour les moniteurs arbitraires sans valider physiquement qu’elles fonctionnent comme prévu.

Définit la position horizontale ou verticale de la zone d’affichage d’un moniteur.

L’augmentation de la position horizontale déplace la zone d’affichage vers le côté droit de l’écran; elle déplace la zone d’affichage vers la gauche. L’augmentation de la position verticale déplace la zone d’affichage vers le haut de l’écran; il déplace la zone d’affichage vers le bas.

Syntaxe

_BOOL SetMonitorDisplayAreaPosition(
  [in] HANDLE           hMonitor,
  [in] MC_POSITION_TYPE ptPositionType,
  [in] DWORD            dwNewPosition
);

Paramètres

[in] hMonitor

Gérer sur un moniteur physique. Pour obtenir le handle du moniteur, appelez GetPhysicalMonitorsFromHMONITOR ou GetPhysicalMonitorsFromIDirect3DDevice9.

[in] ptPositionType

Membre du MC_POSITION_TYPE énumération, spécifiant s’il faut définir la position horizontale ou la position verticale.

[in] dwNewPosition

Position horizontale ou verticale. Pour obtenir la position minimale et la position maximale, appelez GetMonitorDisplayAreaPosition.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE. Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Si cette fonction est prise en charge, la fonction GetMonitorCapabilities retourne l’indicateur MC_CAPS_DISPLAY_AREA_POSITION.

Le retour de cette fonction prend environ 50 millisecondes.

Les positions horizontale et verticale sont des paramètres d’analyse continus. Pour plus d’informations, consultez Utilisation des fonctions de configuration High-Level Monitor.

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	highlevelmonitorconfigurationapi.h
Bibliothèque	Dxva2.lib
DLL	Dxva2.dll

Voir aussi

Surveiller les fonctions de configuration