IDirect3DDevice9::Reset

[アーティクル]
04/08/2010

スワップチェーンのタイプ、サイズ、およびフォーマットをリセットします。

HRESULT 
Reset(
  D3DPRESENT_PARAMETERS* pPresentationParameters
);

パラメータ

pPresentationParameters
新しいプレゼンテーションパラメーターを表す D3DPRESENT_PARAMETERS 構造体へのポインター。この値には NULL を指定できません。
全画面モードに切り替えるときに、Direct3D はバックバッファーフォーマットに一致するデスクトップフォーマットを検索します。これにより、バックバッファーおよびフロントバッファーのフォーマットは同じになります (カラー変換の必要を回避します)。
このメソッドは、次のように設定します。
BackBufferCount、BackBufferWidth、および BackBufferHeight はゼロに設定されます。
BackBufferFormat は、ウィンドウ表示モードの場合にのみ、D3DFMT_UNKNOWN に設定されます。全画面モードの場合はフォーマットを指定する必要があります。

戻り値

返される可能性のある戻り値は次のとおりです。D3D_OK、D3DERR_DEVICELOST、D3DERR_DEVICEREMOVED、D3DERR_DRIVERINTERNALERROR、または D3DERR_OUTOFVIDEOMEMORY (「D3DERR」を参照)。

解説　

IDirect3DDevice9::Reset の呼び出しが失敗すると、デバイスは "リセットされていない" ステート (IDirect3DDevice9::TestCooperativeLevel の呼び出しの戻り値 D3DERR_DEVICENOTRESET で指定) に既にある場合を除き、"失われた" ステート (IDirect3DDevice9::TestCooperativeLevel の呼び出しの戻り値 D3DERR_DEVICELOST で指定) に配置されます。失われたデバイスのコンテキストで IDirect3DDevice9::Reset を使用する方法の詳細については、「IDirect3DDevice9::TestCooperativeLevel」および「喪失したデバイス (Direct3D 9)」を参照してください。

IDirect3DDevice9::Reset を呼び出すと、すべてのテクスチャーメモリーサーフェスが失われ、管理下のテクスチャーはビデオメモリーからフラッシュされ、すべてのステート情報が失われます。デバイスに対して IDirect3DDevice9::Reset メソッドを呼び出す前に、デバイスに関連付けられたすべての明示的なレンダーターゲット、深度ステンシルサーフェス、追加のスワップチェーン、ステートブロック、および D3DPOOL_DEFAULT リソースを解放する必要があります。

スワップチェーンには、次の 2 種類があります。全画面またはウィンドウ表示。新しいスワップチェーンが全画面の場合、アダプターは新しいサイズに一致する表示モードになります。

Direct3D 9 アプリケーションは、このメソッドの呼び出し中 (このメソッドからリターンする前など) にメッセージが送信される場合があります。このため、アプリケーションでは、そのような場合に Direct3D を呼び出さないように注意する必要があります。さらに、IDirect3DDevice9::Reset が失敗すると、呼び出すことができる有効なメソッドは IDirect3DDevice9::Reset、IDirect3DDevice9::TestCooperativeLevel、および各種 Release メンバー関数のみです。その他のメソッドを呼び出すと例外が発生します。

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

Direct3D 9 で IDirect3DDevice9::Reset を呼び出しても、ピクセルシェーダーおよび頂点シェーダーは影響を受けません。アプリケーションで明示的に作成し直す必要はありません。

D3DFMT_UNKNOWN は、IDirect3D9::CreateDevice、IDirect3DDevice9::Reset、および IDirect3DDevice9::CreateAdditionalSwapChain を呼び出すときに、ウィンドウ表示モードのバックバッファーフォーマットに対して指定できます。つまり、ウィンドウ表示モードの IDirect3D9::CreateDevice を呼び出す前に、現在のデスクトップフォーマットをクエリする必要はありません。フルスクリーンモードの場合、バックバッファーフォーマットを指定する必要があります。BackBufferCount をゼロに設定する (BackBufferCount = 0) と、バックバッファーは 1 つになります。

グループ内の複数のディスプレイアダプターをリセットするときは、アダプターグループのディスプレイごとに D3DPRESENT_PARAMETERS 構造体の配列をポイントするように pPresentationParameters を設定します。

D3DCREATE_ADAPTERGROUP_DEVICE を使用してマルチヘッドデバイスを作成した場合、IDirect3DDevice9::Reset では一連の D3DPRESENT_PARAMETERS 構造体 (各構造体で全画面表示を指定) から構成される配列を指定する必要があります。ウィンドウ表示モードに戻るには、デバイスを破棄して、ウィンドウ表示モードでマルチヘッド以外のデバイスを再作成する必要があります。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容

IDirect3DDevice9::Reset

パラメータ

戻り値

解説

要件

関連項目

その他のリソース