Fungsi DwmIsCompositionEnabled (dwmapi.h)

Mendapatkan nilai yang menunjukkan apakah komposisi Desktop Window Manager (DWM) diaktifkan. Aplikasi pada komputer yang menjalankan Windows 7 atau yang lebih lama dapat mendengarkan perubahan status komposisi dengan menangani pemberitahuan WM_DWMCOMPOSITIONCHANGED .

Sintaks

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

Parameter

[out] pfEnabled

Penunjuk ke nilai yang, ketika fungsi ini berhasil dikembalikan, menerima TRUE jika komposisi DWM diaktifkan; jika tidak, FALSE.

Catatan Pada Windows 8, komposisi DWM selalu diaktifkan. Jika aplikasi menyatakan kompatibilitas Windows 8 dalam manifesnya, fungsi ini akan menerima nilai TRUE melalui pfEnabled. Jika tidak ada entri manifes yang ditemukan, kompatibilitas Windows 8 tidak diasumsikan dan fungsi ini menerima nilai FALSE melalui pfEnabled. Hal ini dilakukan agar program lama yang menafsirkan nilai TRUE untuk menyiratkan bahwa mode kontras tinggi nonaktif dapat terus membuat keputusan yang benar tentang merender gambar mereka. (Perhatikan bahwa ini adalah praktik yang buruk—Anda harus menggunakan fungsi SystemParametersInfo dengan bendera SPI_GETHIGHCONTRAST untuk menentukan status mode kontras tinggi.)

 

Untuk informasi selengkapnya, lihat Mendukung Tema Kontras Tinggi.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	dwmapi.h
Pustaka	Dwmapi.lib
DLL	Dwmapi.dll