Metode IDirect3DDevice9::TestCooperativeLevel (d3d9helper.h)

  • Artikel

Melaporkan status tingkat kooperatif perangkat Direct3D saat ini untuk aplikasi berjendela atau layar penuh.

Sintaks

HRESULT TestCooperativeLevel();

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai pengembalian D3D_OK, menunjukkan bahwa perangkat beroperasi dan aplikasi panggilan dapat dilanjutkan. Jika metode gagal, nilai yang dikembalikan bisa menjadi salah satu nilai berikut: D3DERR_DEVICELOST, D3DERR_DEVICENOTRESET, D3DERR_DRIVERINTERNALERROR.

Keterangan

Jika perangkat hilang tetapi tidak dapat dipulihkan pada saat ini, IDirect3DDevice9::TestCooperativeLevel mengembalikan kode pengembalian D3DERR_DEVICELOST. Ini akan terjadi, misalnya, ketika perangkat layar penuh telah kehilangan fokus. Jika aplikasi mendeteksi perangkat yang hilang, aplikasi harus menjeda dan secara berkala memanggil IDirect3DDevice9::TestCooperativeLevel hingga menerima nilai pengembalian D3DERR_DEVICENOTRESET. Aplikasi kemudian dapat mencoba mengatur ulang perangkat dengan memanggil IDirect3DDevice9::Reset dan, jika ini berhasil, pulihkan sumber daya yang diperlukan dan lanjutkan operasi normal. Perhatikan bahwa IDirect3DDevice9::P resent akan mengembalikan D3DERR_DEVICELOST jika perangkat "hilang" atau "tidak diatur ulang".

Panggilan ke IDirect3DDevice9::TestCooperativeLevel akan gagal jika dipanggil pada utas yang berbeda dari yang digunakan untuk membuat perangkat yang direset.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d9helper.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

IDirect3DDevice9