Microsoft DirectX 8.0 (Visual Basic)

Direct3DTexture8.LockRect

テクスチャ リソース上の矩形をロックする。

object.LockRect( _ 
    Level As Long, _ 
    LockedRect As D3DLOCKED_RECT, _ 
    RECT As Any, _ 
    Flags As Long)

指定項目

object
Direct3DTexture8 オブジェクトを表すオブジェクト式。
Level
ロックするテクスチャ リソースのレベルを指定する。
LockedRect
ロックされた領域を記述する D3DLOCKED_RECT 型。
RECT
ロックする矩形。RECT 型によって指定される。または、ByVal 0 の場合はテクスチャ全体を覆うようにダーティー領域が拡大する。
Flags
実行するロックの種類を記述する CONST_D3DLOCKFLAGS 列挙によって定義される 0 個以上の有効なロッキング フラグの組み合わせ。

エラー コード

失敗した場合はエラーが発生し、Err.NumberD3DERR_INVALIDCALL が設定される。

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

D3DPOOL_DEFAULT で作成されたテクスチャはロックできない。

深度ステンシル サーフェスのロック可能なフォーマットは、D3DFMT_D16_LOCKABLE だけである。

マルチサンプル バック バッファはロックできない。ビデオ メモリ テクスチャはロックできないが、Direct3Ddevice8.CopyRects または Direct3Ddevice8.UpdateTexture を呼び出して修正する必要がある。Microsoft® DirectX® 8.0 が認識しない、一部のドライバ独自のピクセル フォーマットは例外である。これらはロックできる。

パフォーマンスの理由によって、ダーティーな範囲はテクスチャのレベルゼロに対して記録されるのみである。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY なしで LockRectLockBox が呼び出されたとき、ダーティーな範囲は自動的に記録される。詳細については、「Direct3DDevice8.UpdateTexture」を参照すること。

参照

Direct3DTexture8.UnlockRect