Platform SDK: DirectX

IDirectDrawSurface7::IsLost

IDirectDrawSurface7::IsLost メソッドは、DirectDrawSurface オブジェクトに関連付けられたサーフェス メモリが解放されたかどうかを判断する。

HRESULT IsLost();

パラメータ

なし。

戻り値

成功すれば、メモリが解放されていないため DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_SURFACELOST

このメソッドを使用して、サーフェス メモリの再割り当てをいつ行うかを決定できる。DirectDrawSurface オブジェクトがサーフェス メモリを消失すると、大部分のメソッドは DDERR_SURFACELOST を返して他のアクションを実行しない。

注意

ディスプレイ カードのモードが変更されると、またはアプリケーションでディスプレイ カードへの排他アクセスを受け取り、ディスプレイ カードに現在割り当てられているサーフェス メモリをすべて解放すると、サーフェスのメモリが消失することがある。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。

参照

IDirectDrawSurface7::Restoreサーフェスの消失とリストア