IDirect3DCubeTexture9::LockRect メソッド (d3d9.h)
キューブ テクスチャ リソースの四角形をロックします。
構文
HRESULT LockRect(
[in] D3DCUBEMAP_FACES FaceType,
[in] UINT Level,
[out] D3DLOCKED_RECT *pLockedRect,
[in] const RECT *pRect,
[in] DWORD Flags
);
パラメーター
[in] FaceType
種類: D3DCUBEMAP_FACES
キューブ マップの顔を識別する、 D3DCUBEMAP_FACES 列挙型のメンバー。
[in] Level
型: UINT
mipmapped キューブ テクスチャのレベルを指定します。
[out] pLockedRect
種類: D3DLOCKED_RECT*
ロックする領域を記述する 、D3DLOCKED_RECT 構造体へのポインター。
[in] pRect
型: const RECT*
ロックする四角形へのポインター。 RECT 構造体へのポインターによって指定されます。 このパラメーターに NULL を指定すると、キューブ テクスチャ全体をカバーするようにダーティ領域が展開されます。
[in] Flags
型: DWORD
実行するロックの種類を記述する 0 個以上のロック フラグの組み合わせ。 このメソッドの有効なフラグは次のとおりです。
- D3DLOCK_DISCARD
- D3DLOCK_NO_DIRTY_UPDATE
- D3DLOCK_NOSYSLOCK
- D3DLOCK_READONLY
戻り値
型: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 1 つ以上の引数が無効な場合、D3DERR_INVALIDCALLが返されます。
解説
パフォーマンス上の理由から、ダーティ領域はテクスチャのレベル 0 に対してのみ記録されます。 IDirect3DCubeTexture9::LockRect がD3DLOCK_NO_DIRTY_UPDATEまたはD3DLOCK_READONLYなしで呼び出されると、ダーティ 領域が自動的に記録されます。 詳細については、「 IDirect3DDevice9::UpdateTexture 」を参照してください。
D3DPOOL_DEFAULTで作成されたキューブ テクスチャはロックできません。 ビデオ メモリで作成されたキューブ テクスチャは、 USAGE_DYNAMICを使用して作成するとロックできます。
深度ステンシル テクスチャのロック可能な形式は 、D3DFMT_D16_LOCKABLEのみです。
要件
対象プラットフォーム | Windows |
ヘッダー | d3d9.h (D3D9.h を含む) |
Library | D3D9.lib |
関連項目
IDirect3DCubeTexture9::AddDirtyRect