Bagikan melalui

METODE IDXGIFactory2::RegisterOcclusionStatusEvent (dxgi1_2.h)

  • Artikel

Mendaftar untuk menerima pemberitahuan perubahan status oklusi dengan menggunakan sinyal peristiwa.

Sintaks

HRESULT RegisterOcclusionStatusEvent(
  [in]  HANDLE hEvent,
  [out] DWORD  *pdwCookie
);

Parameter

[in] hEvent

Handel ke objek peristiwa yang ditetapkan sistem operasi saat pemberitahuan perubahan status oklusi terjadi. Fungsi CreateEvent atau OpenEvent mengembalikan handel ini.

[out] pdwCookie

Pointer ke nilai kunci yang dapat diteruskan aplikasi ke metode IDXGIFactory2::UnregisterOcclusionStatus untuk membatalkan pendaftaran peristiwa pemberitahuan yang ditentukan hEvent .

Menampilkan nilai

RegisterOcclusionStatusEvent mengembalikan:

  • S_OK jika metode berhasil mendaftarkan peristiwa.
  • E_OUTOFMEMORY jika memori tidak tersedia untuk menyelesaikan operasi.
  • DXGI_ERROR_INVALID_CALL jika hEvent bukan handel yang valid atau bukan handel peristiwa.
  • Mungkin kode kesalahan lain yang dijelaskan dalam topik DXGI_ERROR .

Pembaruan Platform untuk Windows 7: Pada Windows 7 atau Windows Server 2008 R2 dengan Pembaruan Platform untuk Windows 7 diinstal, RegisterOcclusionStatusEvent gagal dengan E_NOTIMPL. Untuk informasi selengkapnya tentang Pembaruan Platform untuk Windows 7, lihat Pembaruan Platform untuk Windows 7.

Keterangan

Jika Anda memanggil RegisterOcclusionStatusEvent beberapa kali dengan penanganan aktivitas yang sama, RegisterOcclusionStatusEvent gagal dengan DXGI_ERROR_INVALID_CALL.

Jika Anda memanggil RegisterOcclusionStatusEvent beberapa kali dengan penanganan aktivitas yang berbeda, RegisterOcclusionStatusEvent mendaftarkan peristiwa dengan benar.

Persyaratan

   
Klien minimum yang didukung Pembaruan Windows 8 dan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header dxgi1_2.h
Pustaka Dxgi.lib

Lihat juga

IDXGIFactory2