Funzione GetMonitorInfoA (winuser.h)

  • Articolo

La funzione GetMonitorInfo recupera informazioni su un monitor di visualizzazione.

Sintassi

BOOL GetMonitorInfoA(
  [in]  HMONITOR      hMonitor,
  [out] LPMONITORINFO lpmi
);

Parametri

[in] hMonitor

Handle per il monitoraggio dello schermo di interesse.

[out] lpmi

Puntatore a una struttura MONITORINFO o MONITORINFOEX che riceve informazioni sul monitor di visualizzazione specificato.

È necessario impostare il membro cbSize della struttura su sizeof(MONITORINFO) o sizeof(MONITORINFOEX) prima di chiamare la funzione GetMonitorInfo . In questo modo, la funzione determina il tipo di struttura che si sta passando.

La struttura MONITORINFOEX è un superset della struttura MONITORINFO . Ha un membro aggiuntivo: una stringa che contiene un nome per il monitor visualizzato. La maggior parte delle applicazioni non usa per un nome di monitoraggio visualizzato e quindi può salvare alcuni byte usando una struttura MONITORINFO .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Nota

L'intestazione winuser.h definisce GetMonitorInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

MONITORINFO

MONITORINFOEX

Funzioni monitor multiple

Panoramica dei monitoraggi multipli