IDirect3DDevice9::TestCooperativeLevel メソッド (d3d9.h)
ウィンドウまたは全画面表示アプリケーションの Direct3D デバイスの現在の協調レベルの状態を報告します。
構文
HRESULT TestCooperativeLevel();
戻り値
種類: HRESULT
メソッドが成功した場合、戻り値はD3D_OKされ、デバイスが操作可能であり、呼び出し元のアプリケーションを続行できることを示します。 メソッドが失敗した場合、戻り値には、D3DERR_DEVICELOST、D3DERR_DEVICENOTRESET、D3DERR_DRIVERINTERNALERRORのいずれかの値を指定できます。
注釈
デバイスが失われたが、現在復元できない場合、 IDirect3DDevice9::TestCooperativeLevel はD3DERR_DEVICELOST戻りコードを返します。 これは、たとえば、全画面表示デバイスがフォーカスを失った場合です。 アプリケーションで紛失したデバイスが検出された場合は、 IDirect3DDevice9::TestCooperativeLevel を一時停止して定期的に呼び出し、D3DERR_DEVICENOTRESETの戻り値を受け取る必要があります。 その後、アプリケーションは IDirect3DDevice9::Reset を呼び出してデバイスのリセットを試み、成功した場合は必要なリソースを復元し、通常の操作を再開します。 IDirect3DDevice9::P resent は、デバイスが "失われた" または "リセットされていない" 場合にD3DERR_DEVICELOSTを返します。
IDirect3DDevice9::TestCooperativeLevel の呼び出しは、リセットされるデバイスの作成に使用されたスレッドとは異なるスレッドで呼び出されると失敗します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9.h (D3D9.h を含む) |
| Library | D3D9.lib |