次の方法で共有


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
D3DLOCK_DISCARDを使用する場合は、サブrect を指定することはできません。 フラグの説明については、「 D3DLOCK」を参照してください。

戻り値

型: 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

IDirect3DCubeTexture9::AddDirtyRect

IDirect3DCubeTexture9::GetLevelDesc

IDirect3DCubeTexture9::UnlockRect