IDirectDrawSurface7::P ageUnlock メソッド (ddraw.h)

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

構文

HRESULT PageUnlock(
  [in] DWORD unnamedParam1
);

パラメーター

[in] unnamedParam1

現在は使用されておらず、0 に設定する必要があります。

戻り値

メソッドが成功した場合、戻り値はDD_OK。

失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。

• DDERR_CANTPAGEUNLOCK
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_NOTPAGELOCKED
• DDERR_SURFACELOST

解説

ロックカウントはサーフェスごとに保持され、そのサーフェスに対して IDirectDrawSurface7::P ageLock が呼び出されるたびにインクリメントされます。 PageUnlock が呼び出されると、カウントはデクリメントされます。 カウントが 0 に達すると、メモリのロックが解除され、オペレーティング システムによってページングできるようになります。

PageUnlock は、システム メモリ サーフェスでのみ機能します。表示メモリ サーフェスやエミュレートされたプライマリ サーフェスのページ ロック解除は行われません。 アプリケーションが表示メモリサーフェイスで PageUnlock を呼び出した場合、メソッドはDD_OKを返す以外は何も行いません。

IDirectDrawSurface7::P ageUnlock は IDirectDraw インターフェイス バージョンでは実装されませんでした。

要件

関連項目

IDirectDrawSurface7