Platform SDK: DirectX |
IDirectDrawSurface7::PageUnlock メソッドは、システムメモリ サーフェスのロックを解除して、ページ アウトできるようにする。
HRESULT PageUnlock( DWORD dwFlags );
成功すれば、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 で宣言。