Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.Reset

スワップ チェーンのタイプ、サイズ、およびフォーマットを変更する。

object.Reset( _ 
    PresentationParameters As D3DPRESENT_PARAMETERS)

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
PresentationParameters
新しいプレゼンテーション パラメータを示す D3DPRESENT_PARAMETERS 型。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

Reset の呼び出しが失敗すると、デバイスは "消失" 状態 (TestCooperativeLevel の呼び出しからの戻り値 D3DERR_DEVICELOST が示す) になる。ただし、デバイスが既に "非リセット" 状態 (TestCooperativeLevel の呼び出しからの戻り値 D3DERR_DEVICENOTRESET が示す) の場合は除く。消失したデバイスのコンテキストにおける Reset の使用の詳細については、「Direct3DDevice8.TestCooperativeLevel」および「消失したデバイス」を参照すること。

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

スワップ チェーンのタイプには、フルスクリーンとウィンドウがある。新しいスワップ チェーンがフルスクリーンの場合、アダプタは新しいサイズに合ったディスプレイ モードに設定される。

Reset が失敗した場合、呼び出すことができる有効なメソッドは Reset および Direct3DDevice8.TestCooperativeLevel だけである。その他のメソッドを呼び出すと、例外になる場合がある。

参照

CONST_D3DSWAPEFFECTD3DPRESENT_PARAMETERSDirect3DDevice8.Present