Metode IDirect3DDevice9::TestCooperativeLevel (d3d9helper.h)
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
| Target Platform | Windows |
| Header | d3d9helper.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |