Platform SDK: DirectX

IDirectDrawSurface7::PageUnlock

IDirectDrawSurface7::PageUnlock メソッドは、システムメモリ サーフェスのロックを解除して、ページ アウトできるようにする。

HRESULT PageUnlock(
  DWORD dwFlags  
);

パラメータ

dwFlags
現時点では未使用なので 0 を設定しておく。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_CANTPAGEUNLOCK
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOTPAGELOCKED
DDERR_SURFACELOST

注意

ロック カウントは個々のサーフェスに対して維持され、サーフェスに対して IDirectDrawSurface7::PageLock が呼び出されるたびにインクリメントされる。このカウントは、IDirectDrawSurface7::PageUnlock が呼び出されるとデクリメントされる。ロック カウントが 0 になると、メモリのロックが解除され、オペレーティング システムでページングできるようになる。

このメソッドは、システムメモリ サーフェスに対してだけ作用する。つまり、ディスプレイメモリ サーフェスやエミュレートされるプライマリ サーフェスをページロックすることはできない。アプリケーションがディスプレイメモリ サーフェスでこのメソッドを呼び出した場合、このメソッドは DD_OK を返すだけである。

このメソッドは、IDirectDraw インターフェイスには実装されていない。

動作環境

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

参照

IDirectDrawSurface7::PageLock