METODE IDCompositionDevice::CheckDeviceState (dcomp.h)

  • Artikel

Menentukan apakah objek perangkat DirectComposition masih valid.

Sintaks

HRESULT CheckDeviceState(
  [out] BOOL *pfValid
);

Parameter

[out] pfValid

TRUE jika objek perangkat DirectComposition masih valid; jika tidak FALSE.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Jika perangkat Microsoft DirectX Graphics Infrastructure (DXGI) hilang, perangkat DirectComposition yang terkait dengan perangkat DXGI juga hilang. Saat mendeteksi perangkat yang hilang, DirectComposition mengirimkan pesan WM_PAINT ke semua jendela yang menyusun konten DirectComposition menggunakan perangkat yang hilang. Aplikasi harus memanggil CheckDeviceState sebagai respons terhadap setiap pesan WM_PAINT untuk memastikan bahwa objek perangkat DirectComposition masih valid. Aplikasi harus mengambil langkah-langkah untuk memulihkan konten jika objek perangkat menjadi tidak valid. Langkah-langkah termasuk membuat perangkat DXGI dan DirectComposition baru, dan membuat ulang semua konten. (Tidak dimungkinkan untuk membuat hanya perangkat DXGI baru dan mengaitkannya dengan perangkat DirectComposition yang ada.) Sistem memastikan bahwa objek perangkat tetap valid di antara pesan WM_PAINT .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header dcomp.h
Pustaka Dcomp.lib
DLL Dcomp.dll

Lihat juga

IDCompositionDevice