Microsoft DirectX 8.0 (C++) |
サーフェス上の矩形をロックする。
HRESULT LockRect( D3DLOCKED_RECT* pLockedRect, CONST RECT* pRect, DWORD Flags );
ロック処理は若干負荷が高くなるが、マウス カーソルの移動など、システムでほかの処理を実行することが可能になる。このフラグは、ソフトウェア レンダリングのバックバッファのロックのように、ロックが長時間に及び、システムの応答性に悪影響を与えてしまうようなロックに対して有効である。
成功した場合は、D3D_OK を返す。
失敗した場合は、D3DERR_INVALIDCALL を返す。
深度ステンシル サーフェスのロック可能なフォーマットは、D3DFMT_D16_LOCKABLE だけである。
マルチサンプル バック バッファはロックできない。
パフォーマンスの理由によって、ダーティーな範囲はテクスチャのレベルゼロに対して記録されるのみである。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY なしで LockRect か LockBox が呼び出されたとき、ダーティーな範囲は自動的に記録される。また CopyRects 呼び出しの宛先サーフェイスはダーティーとしてマークされる。詳細については、「IDirect3DDevice8::UpdateTexture」を参照すること。
ヘッダー : d3d8.h で宣言。
インポート ライブラリ : D3d8.lib を使用。