IDirect3DDevice9::TestCoacheLevel 方法 (d3d9.h)
報告視窗式或全螢幕應用程式的 Direct3D 裝置目前合作層級狀態。
Syntax
HRESULT TestCooperativeLevel();
傳回值
類型: HRESULT
如果方法成功,傳回值會D3D_OK,表示裝置正常運作,而且呼叫的應用程式可以繼續。 如果方法失敗,傳回值可以是下列其中一個值:D3DERR_DEVICELOST、D3DERR_DEVICENOTRESET D3DERR_DRIVERINTERNALERROR。
備註
如果裝置遺失,但無法在目前時間還原, IDirect3DDevice9::TestCocolLevel 會傳回D3DERR_DEVICELOST傳回碼。 例如,當全螢幕裝置失去焦點時,就會發生這種情況。 如果應用程式偵測到遺失的裝置,它應該暫停並定期呼叫 IDirect3DDevice9::TestCocolLevel ,直到收到傳回值D3DERR_DEVICENOTRESET為止。 然後,應用程式可能會呼叫 IDirect3DDevice9::Reset 來嘗試重設裝置,如果成功,請還原必要的資源並繼續正常作業。 請注意,如果裝置為「遺失」或「未重設」, IDirect3DDevice9::P resent 將會傳回D3DERR_DEVICELOST。
如果在與用來建立重設裝置不同的線程上呼叫 IDirect3DDevice9::TestCocolLevel 將會失敗。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | d3d9.h (包含 D3D9.h) |
程式庫 | D3D9.lib |