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