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

另請參閱

IDirect3DDevice9