Funzione GetMonitorInfoA (winuser.h)

Articolo
11/20/2024

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 a cui si passa.

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 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
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)

Vedere anche

MONITORINFO

MONITORINFOEX

più funzioni monitoraggi display

panoramica di più monitoraggi display

Condividi tramite