IDirect3DDevice9::TestCooperativeLevel メソッド (d3d9helper.h)

  • [アーティクル]

ウィンドウまたは全画面表示アプリケーションの Direct3D デバイスの現在の協調レベルの状態を報告します。

構文

HRESULT TestCooperativeLevel();

戻り値

型: HRESULT

メソッドが成功した場合、戻り値はD3D_OKされ、デバイスが操作可能であり、呼び出し元のアプリケーションを続行できることを示します。 メソッドが失敗した場合、戻り値には、D3DERR_DEVICELOST、D3DERR_DEVICENOTRESET、D3DERR_DRIVERINTERNALERRORのいずれかの値を指定できます。

注釈

デバイスが失われたが、現在復元できない場合、 IDirect3DDevice9::TestCooperativeLevel はD3DERR_DEVICELOSTリターン コードを返します。 たとえば、全画面表示デバイスがフォーカスを失った場合などです。 失われたデバイスが検出された場合、アプリケーションは一時停止し、戻り値 D3DERR_DEVICENOTRESETを受け取るまで IDirect3DDevice9::TestCooperativeLevel を定期的に呼び出す必要があります。 その後、アプリケーションは IDirect3DDevice9::Reset を呼び出してデバイスのリセットを試み、成功した場合は必要なリソースを復元し、通常の操作を再開します。 IDirect3DDevice9::P resent は、デバイスが "紛失" または "リセットされていない" 場合にD3DERR_DEVICELOSTを返します。

リセットするデバイスの作成に使用したスレッドとは異なるスレッドで IDirect3DDevice9::TestCooperativeLevel を呼び出すと、呼び出しは失敗します。

要件

要件 値
対象プラットフォーム Windows
ヘッダー d3d9helper.h (D3D9.h を含む)
Library D3D9.lib

こちらもご覧ください

IDirect3DDevice9