Funzione DwmIsCompositionEnabled (dwmapi.h)

  • Articolo

Ottiene un valore che indica se la composizione di Desktop Window Manager (DWM) è abilitata. Le applicazioni nei computer che eseguono Windows 7 o versioni precedenti possono rimanere in ascolto delle modifiche dello stato di composizione gestendo la notifica di WM_DWMCOMPOSITIONCHANGED .

Sintassi

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

Parametri

[out] pfEnabled

Puntatore a un valore che, quando questa funzione viene restituita correttamente, riceve TRUE se la composizione DWM è abilitata; in caso contrario, FALSE.

Nota A partire da Windows 8, la composizione DWM è sempre abilitata. Se un'app dichiara Windows 8 compatibilità nel manifesto, questa funzione riceverà un valore TRUE tramite pfEnabled. Se non viene trovata alcuna voce manifesto di questo tipo, non si presuppone Windows 8 compatibilità e questa funzione riceve un valore FALSE tramite pfEnabled. Questa operazione viene eseguita in modo che i programmi meno recenti che interpretano un valore TRUE per indicare che la modalità a contrasto elevato è disattivata può continuare a prendere le decisioni corrette sul rendering delle immagini. Si noti che si tratta di una procedura non valida. È consigliabile usare la funzione SystemParametersInfo con il flag SPI_GETHIGHCONTRAST per determinare lo stato della modalità a contrasto elevato.
 
Per altre informazioni, vedere Supporto di temi a contrasto elevato.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dwmapi.h
Libreria Dwmapi.lib
DLL Dwmapi.dll